Метод ICEnroll::p ut_ContainerName (xenroll.h)

Статья
08/28/2023

[Это свойство больше не доступно для использования в Windows Server 2008 и Windows Vista.]

Свойство ContainerName задает или извлекает имя контейнера ключей для использования.

Это свойство было впервые определено в интерфейсе ICEnroll .

Это свойство является чтением и записью.

Синтаксис

HRESULT put_ContainerName(
  BSTR bstrContainer
);

Параметры

bstrContainer

Возвращаемое значение

None

Remarks

Указанный контейнер может быть существующим или новым. Он может быть существующим контейнером, только если задано свойство UseExistingKeySet , если набор ключей еще не создан. Например, если для контейнера создан только набор ключей exchange , регистрацию сертификата можно выполнить с помощью набора ключей подписи без настройки 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
Header	xenroll.h
Библиотека	Uuid.lib
DLL	Xenroll.dll

Поделиться через