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

Статья
03/04/2024

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

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

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

Это свойство доступно для чтения и записи.

Синтаксис

HRESULT get_ContainerName(
  BSTR *pbstrContainer
);

Параметры

pbstrContainer

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

None

Remarks

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

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