ICEnroll3::p ut_ReuseHardwareKeyIfUnableToGenNew メソッド (xenroll.h)

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

ReuseHardwareKeyIfUnableToGenNew プロパティは、新しいキーの生成時にエラーが発生した場合に証明書登録コントロール オブジェクトによって実行されるアクションを決定するブール値を設定または取得します。

このプロパティは、 ICEnroll3 インターフェイスで最初に定義されました。

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

構文

HRESULT put_ReuseHardwareKeyIfUnableToGenNew(
  BOOL fReuseHardwareKeyIfUnableToGenNew
);

パラメーター

fReuseHardwareKeyIfUnableToGenNew

戻り値

なし

解説

このプロパティはブール値です。 このプロパティは、NTE_TOKEN_KEYSET_STORAGE_FULLを返す 暗号化サービス プロバイダー にのみ影響します。 通常、これらの CSP はハードウェア ベースです。たとえば、スマート カードです。 このプロパティが true で、新しいキーの生成中にエラーが発生した場合、証明書登録コントロール オブジェクトは既存のハードウェア キーを再利用します。 このプロパティが false で、新しいキーの生成中にエラーが発生した場合、証明書登録コントロール オブジェクトは既存のハードウェア キーを再利用せず、代わりに呼び出し元にエラーを渡します。

例

// Code to set the reuse H/W key status.
// hr is HRESULT variable.
hr = pEnroll->put_ReuseHardwareKeyIfUnableToGenNew( FALSE );
if ( FAILED( hr ) )    
    printf("Failed put_ReuseHardwareKeyIfUnableToGenNew [%x]\n", hr);


// Code to retrieve the reuse H/W key status.
BOOL bReuse;

hr = pEnroll->get_ReuseHardwareKeyIfUnableToGenNew( &bReuse );
if ( FAILED( hr ) )
    printf("Failed get_ReuseHardwareKeyIfUnableToGenNew [%x]\n", hr);
else
    printf("Hardware key %s be reused if unable"
        " to generate a new key.\n", bReuse ? "will" : "will not");

要件

こちらもご覧ください

CEnroll

ICEnroll3

ICEnroll4