ホーム › Security.Authentication.Identity › SpAcceptCredentialsFn

SpAcceptCredentialsFn

コールバック

シグネチャ

NTSTATUS SpAcceptCredentialsFn(
    SECURITY_LOGON_TYPE LogonType,
    LSA_UNICODE_STRING* AccountName,
    SECPKG_PRIMARY_CRED* PrimaryCredentials,
    SECPKG_SUPPLEMENTAL_CRED* SupplementalCredentials
);

パラメーター

フィールド	型	説明
LogonType	SECURITY_LOGON_TYPE	ログオンの種類を示す SECURITY_LOGON_TYPE 値です。
AccountName	LSA_UNICODE_STRING*	ログオンしたアカウントの名前を指定する UNICODE_STRING 構造体へのポインターです。
PrimaryCredentials	SECPKG_PRIMARY_CRED*	ログオンに使用された資格情報を格納する SECPKG_PRIMARY_CRED 構造体へのポインターです。この構造体のメンバーは NULL になることがあります。
SupplementalCredentials	SECPKG_SUPPLEMENTAL_CRED*	パッケージ固有の補足資格情報を格納する SECPKG_SUPPLEMENTAL_CRED 構造体へのポインターです。

公式ドキュメント

認証されたセキュリティプリンシパルに対して保存されている資格情報をセキュリティパッケージに渡すために、ローカルセキュリティ機関 (LSA) から呼び出されます。この関数は、LSA が保存している資格情報のセットごとに 1 回呼び出されます。

戻り値

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

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

解説(Remarks)

セキュリティパッケージは、資格情報の要求に応じられるように、資格情報を保存する必要があります。詳細については、 SpAcquireCredentialsHandle 関数を参照してください。

SSP/AP は SpAcceptCredentials 関数を実装する必要があります。他の SSP/AP 関数とは異なり、この関数の名前は SpAcceptCredentials でなければなりません。

LSA は、 SpLsaModeInitialize 関数から受け取った SECPKG_FUNCTION_TABLE 構造体を通じて SpAcceptCredentials 関数にアクセスします。

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