Метод 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 |