SpAcceptCredentialsFn コールバック関数 (ntsecpkg.h)

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

構文

SpAcceptCredentialsFn Spacceptcredentialsfn;

NTSTATUS Spacceptcredentialsfn(
  [in] SECURITY_LOGON_TYPE LogonType,
  [in] PUNICODE_STRING AccountName,
  [in] PSECPKG_PRIMARY_CRED PrimaryCredentials,
  [in] PSECPKG_SUPPLEMENTAL_CRED SupplementalCredentials
)
{...}

パラメーター

[in] LogonType

ログオンの種類を示す SECURITY_LOGON_TYPE 値。

[in] AccountName

ログオンしているアカウントの名前を指定する UNICODE_STRING 構造体へのポインター。

[in] PrimaryCredentials

ログオンに使用 される 資格情報を含むSECPKG_PRIMARY_CRED構造体へのポインター。 この構造体には NULL メンバーを含めることができます。

[in] SupplementalCredentials

パッケージ固有の補足資格情報を含むSECPKG_SUPPLEMENTAL_CRED構造体へのポインター。

戻り値

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

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

注釈

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

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

LSA は、SpLsaModeInitialize 関数から受信したSECPKG_FUNCTION_TABLE構造体を介して SpAcceptCredentials 関数にアクセスします。

要件

こちらもご覧ください

SECPKG_PRIMARY_CRED

SECPKG_SUPPLEMENTAL_CRED

SECURITY_LOGON_TYPE

SpAcquireCredentialsHandle

SpLsaModeInitialize