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

  • [アーティクル]

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

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

構文

SpQueryCredentialsAttributesFn Spquerycredentialsattributesfn;

NTSTATUS Spquerycredentialsattributesfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  ULONG CredentialAttribute,
  [out] PVOID Buffer
)
{...}

パラメーター

[in] CredentialHandle

クエリを実行する資格情報へのハンドル。

[in] CredentialAttribute

クエリを実行する属性。 次の表に、有効な値を示します。

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

[out] Buffer

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

戻り値

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

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

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

注釈

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

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

要件

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

こちらもご覧ください

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize