ICEnroll::p ut_RequestStoreName 方法 (xenroll.h)

[从 Windows Server 2008 和 Windows Vista 起,此属性不再可供使用。]

RequestStoreName 属性设置或检索ICEnroll 包含虚拟证书的存储的名称。 此虚拟证书以及添加的私钥将保留在请求存储中,直到 证书颁发机构 处理请求并使用 PKCS #7 做出响应。

此属性的默认值为“REQUEST”。 如果不使用默认值,则必须将此属性设置为在调用 createPKCS10 或 createFilePKCS10 之前以及调用 acceptPKCS7acceptFilePKCS7 之前使用的存储。

此属性首先在 ICEnroll 接口中定义。

此属性是可读写的。

语法

HRESULT put_RequestStoreName(
  BSTR bstrName
);

参数

bstrName

返回值

备注

通常, RequestStoreName 属性的修改仅在高级应用程序中执行。 不建议对大多数应用程序更改此值。

RequestStoreName 属性会影响以下方法的行为:

当证书注册控件作为脚本控件执行时,将禁用设置此属性的功能。

示例

BSTR     bstrStoreName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the storename
hr = pEnroll->get_RequestStoreName( &bstrStoreName );
if ( FAILED ( hr ) )
    printf("Failed getting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName: %ws\n", bstrStoreName );
// free BSTR when done
if ( NULL != bstrStoreName )
    SysFreeString( bstrStoreName );

// set the storename
// bstrNewName is a BSTR that is previously set to a valid store name
hr = pEnroll->put_RequestStoreName( bstrNewName );
if ( FAILED ( hr ) )
    printf("Failed setting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName was set to : %ws\n", bstrNewName );

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 xenroll.h
Library Uuid.lib
DLL Xenroll.dll