ICEnroll：:p ut_RootStoreName 方法 (xenroll.h)

  • 项目

[此属性在 Windows Server 2008 和 Windows Vista 中不再可用。]

RootStoreName 属性设置或检索根存储的名称，其中保留所有固有信任的自签名根证书。

此属性的默认值为“ROOT”。 由于与根存储关联的信任级别，可能会通过用户界面) 提示用户接受证书 (。 尽管许多应用程序不需要更改此属性，但为了避免与信任 根证书关联的用户界面，可以将 RootStoreName 设置为“CA”。

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

此属性是可读写的。

语法

HRESULT put_RootStoreName(
  BSTR bstrName
);

参数

bstrName

返回值

无

备注

RootStoreName 影响以下方法的行为：

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

示例

BSTR     bstrStoreName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the storename
hr = pEnroll->get_RootStoreName( &bstrStoreName );
if ( FAILED ( hr ) )
    printf("Failed getting RootStoreName - %x\n", hr );
else
    printf( "RootStoreName: %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_RootStoreName( bstrNewName );
if ( FAILED ( hr ) )
    printf("Failed setting RootStoreName - %x\n", hr );
else
    printf( "RootStoreName was set to : %ws\n", bstrNewName );

要求

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