QueryCredentialsAttributesA 関数 (sspi.h)

[アーティクル]
03/02/2024

資格情報に関連付けられている名前など、資格情報の属性を取得します。この情報は、指定された資格情報で作成されたすべてのセキュリティコンテキストに対して有効です。

構文

SECURITY_STATUS SEC_ENTRY QueryCredentialsAttributesA(
  [in]  PCredHandle   phCredential,
  [in]  unsigned long ulAttribute,
  [out] void          *pBuffer
);

パラメーター

[in] phCredential

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

[in] ulAttribute

クエリを実行する属性を指定します。このパラメーターには、次のいずれかの属性を指定できます。

値	意味
SECPKG_CRED_ATTR_CERT	SecPkgCredentials_Cert型の pbuffer で証明書の拇印を返します。この属性は Kerberos でのみサポートされています。 Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この属性は使用できません。
SECPKG_CRED_ATTR_NAMES	SecPkgCredentials_Names 型の pbuffer 内の資格情報の名前を返します。この属性は、WOW64 モードの Schannel ではサポートされていません。
SECPKG_ATTR_SUPPORTED_ALGS	SecPkgCred_SupportedAlgs型の pbuffer でサポートされているアルゴリズムを返します。サポートされているすべてのアルゴリズムは、指定された証明書でサポートされているか、ローカルコンピューターで有効になっているかに関係なく含まれます。この属性は、Schannel でのみサポートされています。
SECPKG_ATTR_CIPHER_STRENGTHS	SecPkgCred_CipherStrengths型の pbuffer で暗号強度を返します。この属性は、Schannel でのみサポートされています。
SECPKG_ATTR_SUPPORTED_PROTOCOLS	SecPkgCred_SupportedProtocols型の pbuffer でサポートされているアルゴリズムを返します。サポートされているすべてのプロトコルは、指定された証明書でサポートされているか、ローカルコンピューターで有効になっているかに関係なく含まれます。この属性は、Schannel でのみサポートされています。

[out] pBuffer

要求された属性を受け取るバッファーへのポインター。返される構造体の型は、 ulAttribute の値によって異なります。

戻り値

関数が成功した場合、戻り値はSEC_E_OK。

関数が失敗した場合、戻り値は次のいずれかのエラーコードになります。

リターンコード	説明
SEC_E_INVALID_HANDLE	関数に渡されたハンドルが無効です。
SEC_E_UNSUPPORTED_FUNCTION	指定した属性は、Schannel ではサポートされていません。この戻り値は、Schannel SSP が使用されている場合にのみ返されます。
SEC_E_INSUFFICIENT_MEMORY	使用可能なメモリは、要求を完了するのに十分ではありません。

注釈

QueryCredentialsAttributes 関数を使用すると、アプリケーションは、指定された資格情報に関連付けられている名前など、資格情報のいくつかの特性を判断できます。

SECPKG_ATTR_CIPHER_STRENGTHS属性のクエリを実行すると、 SecPkgCred_CipherStrengths 構造体が返されます。この構造体の暗号強度は、資格情報の作成時に使用される SCH_CREDENTIALS 構造の暗号強度と同じです。

メモアプリケーションは、既定の資格情報を使用してこの属性に対してクエリを実行することで、システムの既定の暗号強度を見つけることができます。既定の資格情報は、NULLpAuthData パラメーターを使用して AcquireCredentialsHandle を呼び出すことによって作成されます。

SECPKG_ATTR_SUPPORTED_ALGS属性のクエリを実行すると、 SecPkgCred_SupportedAlgs 構造体が返されます。この構造のアルゴリズムは、資格情報の作成時に使用される SCH_CREDENTIALS 構造に示されているものと互換性があります。

SECPKG_ATTR_SUPPORTED_PROTOCOLS属性のクエリを実行すると、 SCH_CREDENTIALS 構造体の grbitEnabledProtocols フィールドと互換性のあるビット配列を含む SecPkgCred_SupportedProtocols 構造体が返されます。

呼び出し元は 、pBuffer パラメーターによって指される構造体を割り当てる必要があります。セキュリティパッケージは、pBuffer 構造体で返されるすべてのポインターにバッファーを割り当てます。呼び出し元は FreeContextBuffer 関数を呼び出して、セキュリティパッケージによって割り当てられたポインターを解放できます。

注意

sspi.h ヘッダーは、QueryCredentialsAttributes をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	sspi.h (Security.h を含む)
Library	Secur32.lib
[DLL]	Secur32.dll