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

[自 Windows Server 2008 和 Windows Vista 起，這個屬性已不再可供使用。]

ContainerName屬性會設定或擷取要使用的金鑰容器名稱。

此屬性最初是在 ICEnroll 介面中定義。

這是可讀寫的屬性。

語法

HRESULT put_ContainerName(
  BSTR bstrContainer
);

參數

bstrContainer

傳回值

無

備註

指定的容器可以是現有的容器或新的容器。 只有在已設定 UseExistingKeySet 屬性時，它才可能是現有的容器，只要尚未產生金鑰集即可。 例如，如果容器只產生 交換金鑰 集，仍然可以使用簽章金鑰集來執行憑證註冊，而不設定 UseExistingKeySet。 如果事先設定 UseExistingKeySet，可以使用交換金鑰集。

根據預設，每次執行 ICEnroll 控制項時，都會選取新的容器。 這可確保產生新的金鑰集。 如果未明確設定此屬性，產生的 GUID 會當做容器名稱使用。

ContainerName屬性會影響下列方法的行為：

• createPKCS10
• createFilePKCS10

範例

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
程式庫	Uuid.lib
Dll	Xenroll.dll