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