ホーム › Security.Authentication.Identity › SpQueryContextAttributesFn

SpQueryContextAttributesFn

コールバック

シグネチャ

NTSTATUS SpQueryContextAttributesFn(
    UINT_PTR ContextHandle,
    DWORD ContextAttribute,
    void* Buffer
);

パラメーター

フィールド	型	説明
ContextHandle	UINT_PTR	セキュリティコンテキストのハンドルです。
ContextAttribute	DWORD	照会するコンテキスト属性です。有効な値の一覧については、 QueryContextAttributes (General) 関数を参照してください。
Buffer	void*	要求された属性を格納するバッファーのアドレスを受け取るポインターです。Buffer パラメーターのメモリは、ユーザーモードでは SECPKG_DLL_FUNCTIONS 関数テーブルの AllocateHeap 関数で割り当ててください。Local Security Authority (LSA) モードでは、 AllocateLsaHeap 関数を使用します。

公式ドキュメント

SpQueryContextAttributes 関数は、セキュリティコンテキストの属性を取得します。

SpQueryContextAttributes 関数は、 Security Support Provider Interface の QueryContextAttributes (General) 関数のディスパッチ関数です。

戻り値

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

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

戻り値	説明
SEC_E_INVALID_HANDLE	ハンドルが無効です。

解説(Remarks)

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

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

SpQueryContextAttributes 関数のユーザーモード実装へのポインターは、 SpUserModeInitialize 関数から受け取る SECPKG_USER_FUNCTION_TABLE 構造体から取得できます。

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