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 |