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

另请参阅

CEnroll

ICEnroll3

ICEnroll4