ICEnroll3::GetSupportedKeySpec メソッド (xenroll.h)

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

[このメソッドは、Windows Server 2008 および Windows Vista では使用できなくなりました。

GetSupportedKeySpec メソッドは、署名や交換操作に対する現在の暗号化サービスプロバイダー (CSP) サポートに関する情報を取得します。このメソッドは、 ICEnroll3 インターフェイスで最初に定義されました。

このメソッドによって取得される値は、現在の CSP によって異なります。

構文

HRESULT GetSupportedKeySpec(
  [out] LONG *pdwKeySpec
);

パラメーター

[out] pdwKeySpec

現在の CSP が交換キーと署名キーをサポートしているかどうかを示すビットフラグを受け取る LONG へのポインター。

戻り値

C++

メソッドが成功した場合、メソッドは S_OKを返します。

メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、「共通の HRESULT 値」を参照してください。

VB

現在の CSP が交換キーと署名キーをサポートしているかどうかを示す値を返します。 CSP がこのメソッドをサポートしていない場合は、エラーが返されます。

注釈

現在の CSP が交換キー、署名キー、またはその両方をサポートしているかどうかを判断するには、このメソッドを呼び出します。 pdwKeySpec パラメーターには、次の定数 (Wincrypt.h で定義) の 1 つ以上が含まれます。

AT_KEYEXCHANGE
AT_SIGNATURE

例

DWORD dwKeySpec;

// Determine the supported key specifications.
// hr is HRESULT variable.
hr = pEnroll->GetSupportedKeySpec( &dwKeySpec );
if ( FAILED( hr ) )    
    printf("Failed GetSupportedKeySpec [%x]\n", hr);
else
{
    printf("Exchange keys are %s. Signature keys are %s.\n",
           dwKeySpec & AT_KEYEXCHANGE ? "supported" : "not supported",
           dwKeySpec & AT_SIGNATURE ? "supported" : "not supported" );
}

要件

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