Win32 API 日本語リファレンス
ホーム › Security.Authentication.Identity › SpAddCredentialsFn

SpAddCredentialsFn

コールバック

シグネチャ

NTSTATUS SpAddCredentialsFn(
    UINT_PTR CredentialHandle,
    LSA_UNICODE_STRING* PrincipalName,
    LSA_UNICODE_STRING* Package,
    DWORD CredentialUseFlags,
    void* AuthorizationData,
    void* GetKeyFunciton,
    void* GetKeyArgument,
    LONGLONG* ExpirationTime
);

パラメーター

フィールド型説明
CredentialHandleUINT_PTR追加する資格情報へのハンドル。
PrincipalNameLSA_UNICODE_STRING*省略可能。資格情報を追加するセキュリティプリンシパルの名前を格納した UNICODE_STRING 構造体へのポインター。
PackageLSA_UNICODE_STRING*認証パッケージの名前を格納した UNICODE_STRING 構造体へのポインター。
CredentialUseFlagsDWORD

資格情報の使用方法を示すフラグ。次の値が有効です。

値 意味
SECPKG_CRED_INBOUND
 資格情報は AcceptSecurityContext (General) 関数で使用されます。
SECPKG_CRED_OUTBOUND
 資格情報は InitializeSecurityContext (General) 関数で使用されます。
AuthorizationDatavoid*省略可能。補足的な認証データへのポインター。
GetKeyFuncitonvoid*
GetKeyArgumentvoid*GetKeyFunction 関数で使用される引数へのポインター。
ExpirationTimeLONGLONG*資格情報ハンドルの有効期限が切れる時刻を受け取る TimeStamp へのポインター。

公式ドキュメント

セキュリティプリンシパルの資格情報を追加するために使用されます。

戻り値

関数が成功した場合は、STATUS_SUCCESS を返します。

関数が失敗した場合は、失敗の理由を示す NTSTATUS コードを返します。

解説(Remarks)

SSP/AP は SpAddCredentials 関数を実装する必要がありますが、実装に付ける実際の名前は開発者が決定します。

SpAddCredentials 関数へのポインターは、 SpLsaModeInitialize 関数から受け取る SECPKG_FUNCTION_TABLE 構造体で利用できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)