ICEnroll::p ut_KeySpec メソッド (xenroll.h)

[このプロパティは、Windows Server 2008 および Windows Vista では使用できなくなりました。

KeySpec プロパティは、生成されたキーの種類を設定または取得します。

有効な値は、使用中の 暗号化サービス プロバイダー (CSP) によって決定されます。 このプロパティは、 ICEnroll インターフェイスで最初に定義されました。

このプロパティは読み取り/書き込み可能です。

構文

HRESULT put_KeySpec(
  LONG dw
);

パラメーター

dw

戻り値

なし

解説

Microsoft Base Cryptographic Provider の場合、 KeySpec プロパティの値は exchange キーの場合は AT_KEYEXCHANGE、署名キーの場合は AT_SIGNATURE です。 既定値は AT_SIGNATURE です。

その他の Microsoft CSP の詳細については、CryptoAPI 2.0 ドキュメントの 「暗号化サービス プロバイダー 」を参照してください。

その他の CSP の詳細については、CSP に付属のドキュメントを参照してください。

KeySpec プロパティは、次のメソッドの動作に影響します。

• createPKCS10
• createFilePKCS10

例

DWORD    dwKeySpec;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the KeySpec value
hr = pEnroll->get_KeySpec( &dwKeySpec );
if (FAILED( hr ))
    printf("Failed get_KeySpec - %x\n", hr );
else
    printf( "KeySpec: %d\n", dwKeySpec );

// set the KeySpec value
hr = pEnroll->put_KeySpec( AT_KEYEXCHANGE );
if (FAILED( hr ))
    printf("Failed put_KeySpec - %x\n", hr );
else
    printf( "KeySpec set to %d\n", AT_KEYEXCHANGE );

要件