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 |