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