ホーム › Security.Authentication.Identity › SpQueryCredentialsAttributesFn

SpQueryCredentialsAttributesFn

コールバック

シグネチャ

NTSTATUS SpQueryCredentialsAttributesFn(
    UINT_PTR CredentialHandle,
    DWORD CredentialAttribute,
    void* Buffer
);

パラメーター

フィールド

型

説明

CredentialHandle

UINT_PTR

照会する資格情報へのハンドルです。

CredentialAttribute

DWORD

照会する属性です。有効な値を次の表に示します。

値	意味
SECPKG_CRED_ATTR_NAMES	資格情報に関連付けられたプリンシパルの名前。
SECPKG_ATTR_SUPPORTED_ALGS	特定の資格情報でサポートされるアルゴリズム。
SECPKG_ATTR_CIPHER_STRENGTHS	資格情報で使用される暗号強度の最小値と最大値。
SECPKG_ATTR_SUPPORTED_PROTOCOLS	特定の資格情報でサポートされるプロトコル。

Buffer

void*

要求された属性を受け取るバッファーへのポインターです。このバッファーのメモリは AllocateClientBuffer 関数を使用して割り当ててください。そうすることで、呼び出し元は FreeContextBuffer 関数を呼び出して解放できます。

公式ドキュメント

SpQueryCredentialsAttributes 関数は、資格情報の属性を取得します。

SpQueryCredentialsAttributes 関数は、 Security Support Provider Interface の QueryCredentialsAttributes 関数に対応するディスパッチ関数です。

戻り値

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

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

戻り値	説明
SEC_E_INSUFFICIENT_MEMORY	メモリの割り当てに失敗しました。
SEC_E_INVALID_HANDLE	資格情報のハンドルが無効です。

解説(Remarks)

SSP/AP は SpQueryCredentialsAttributes 関数を実装する必要があります。ただし、実装に付ける実際の名前は開発者が自由に決められます。

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

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