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

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

Метод enumContainers извлекает имена контейнеров для поставщика служб шифрования (CSP), указанного свойством ProviderName . Этот метод был впервые определен в интерфейсе ICEnroll .

Синтаксис

HRESULT enumContainers(
  [in]  LONG dwIndex,
  [out] BSTR *pbstr
);

Параметры

[in] dwIndex

Указывает порядковый номер контейнера, имя которого будет извлечено. Укажите ноль для первого контейнера.

[out] pbstr

Указатель на переменную BSTR , получающую имя контейнера. Завершив использование BSTR, освободите его, вызвав функцию SysFreeString .

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

C++

Возвращаемое значение — HRESULT. Значение S_OK указывает на успешное выполнение. Значение ERROR_NO_MORE_ITEMS возвращается, если элементов больше нет.

VB

Возвращаемое значение является строковой переменной, представляющей имя контейнера. Исключение возникает при обнаружении ошибки или отсутствии элементов.

Комментарии

Если значение свойства ProviderName не задано, используется значение по умолчанию (обычно Microsoft Base Cryptographic Provider) параметра ProviderName , заданное в реестре.

Этот метод отключается, когда элемент управления регистрацией сертификатов выполняется как элемент управления с помощью скрипта.

Примеры

BSTR       bstrCon = NULL;
DWORD      nCon = 0;
HRESULT    hr;

// pEnroll is previously instantiated ICEnroll interface pointer
while ( S_OK == pEnroll->enumContainers(nCon, &bstrCon) )
{
    printf("\t%d) %ws\n", nCon++, bstrCon );
    if ( bstrCon )
    {
        SysFreeString( bstrCon );
        bstrCon = NULL;
    }
}

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	xenroll.h
Библиотека	Uuid.lib
DLL	Xenroll.dll

См. также раздел

CEnroll

ICEnroll

ICEnroll2

ICEnroll3

ICEnroll4

ProviderName