icEnroll::get_ContainerName 方法 (xenroll.h)
[此属性在 Windows Server 2008 和 Windows Vista 中不再可用。]
ContainerName 属性设置或检索要使用的密钥容器的名称。
此属性首先在 ICEnroll 接口中定义。
此属性是可读写的。
语法
HRESULT get_ContainerName(
BSTR *pbstrContainer
);
参数
pbstrContainer
返回值
无
备注
指定的容器可以是现有容器,也可以是新容器。 如果设置了 UseExistingKeySet 属性,则它只能是现有容器,前提是尚未生成密钥集。 例如,如果只为容器生成了 交换密钥 集,则仍可使用签名密钥集执行证书注册,而无需设置 UseExistingKeySet。 如果事先设置 UseExistingKeySet,可以使用交换密钥集。
默认情况下,每次运行 ICEnroll 控件时都会选择一个新容器。 这可确保生成新的密钥集。 如果未显式设置此属性,则会使用生成的 GUID 作为容器名称。
ContainerName 属性影响以下方法的行为:
示例
BSTR bstrContainerName = NULL;
HRESULT hr;
// pEnroll is previously instantiated ICEnroll interface pointer
// get the container name
hr = pEnroll->get_ContainerName( &bstrContainerName );
if ( FAILED ( hr ) )
printf("Failed getting ContainerName - %x\n", hr );
else
printf( "ContainerName: %ws\n", bstrContainerName );
// free BSTR when done
if ( NULL != bstrContainerName )
SysFreeString( bstrContainerName );
// set the container name
// bstrMyName previously set to a valid name
hr = pEnroll->put_ContainerName( bstrMyName );
if ( FAILED ( hr ) )
printf("Failed setting ContainerName - %x\n", hr );
else
printf( "ContainerName was set to %ws\n", bstrMyName );
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | xenroll.h |
Library | Uuid.lib |
DLL | Xenroll.dll |