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

  • [アーティクル]

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

SpQueryContextAttributes 関数は、セキュリティ サポート プロバイダー インターフェイスの QueryContextAttributes (General) 関数のディスパッチ関数です。

構文

SpQueryContextAttributesFn Spquerycontextattributesfn;

NTSTATUS Spquerycontextattributesfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  ULONG ContextAttribute,
  [out] PVOID Buffer
)
{...}

パラメーター

[in] ContextHandle

セキュリティ コンテキストへのハンドル。

[in] ContextAttribute

クエリするコンテキスト属性。 有効な値の一覧については、 QueryContextAttributes (General) 関数を参照してください。

[out] Buffer

要求された属性を含むバッファーのアドレスを受け取るポインター。 Buffer パラメーターのメモリは、ユーザー モードのSECPKG_DLL_FUNCTIONS関数テーブルから AllocateHeap 関数を使用して割り当てる必要があります。 ローカル セキュリティ機関 (LSA) モードでは、AllocateLsaHeap 関数を使用します。

戻り値

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

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

リターン コード 説明
SEC_E_INVALID_HANDLE
 ハンドルが無効です。

注釈

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

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

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

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー ntsecpkg.h

こちらもご覧ください

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize