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

SpGetCredentials 関数は、ユーザーオブジェクトからプライマリ資格情報と補足資格情報を取得します。

構文

SpGetCredentialsFn Spgetcredentialsfn;

NTSTATUS Spgetcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [out] PSecBuffer Credentials
)
{...}

[in] CredentialHandle

取得する資格情報へのハンドル。

[out] Credentials

資格情報を受け取る SecBuffer 構造体へのポインター。

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

関数が失敗した場合は、失敗した理由を示す NTSTATUS コードを返します。次に、失敗の一般的な理由と、関数が返すエラーコードを示します。

リターンコード	説明
SEC_E_INSUFFICIENT_MEMORY	資格情報を取得するのに十分なメモリがありません。
SEC_E_INVALID_HANDLE	ハンドルが無効です。

SSP/AP は SpGetCredentials 関数を実装する必要があります。ただし、実装に与えられる実際の名前は開発者次第です。

SpGetCredentials 関数へのポインターは、SpLsaModeInitialize 関数から受信したSECPKG_FUNCTION_TABLE構造体で使用できます。