Метод ICertEncodeCRLDistInfo::GetNameChoice (certenc.h)

Статья
08/22/2023

Метод GetNameChoice возвращает выбор имени по указанному индексу точки распространения списка отзыва сертификатов (CRL).

Синтаксис

HRESULT GetNameChoice(
  [in]  LONG DistPointIndex,
  [in]  LONG NameIndex,
  [out] LONG *pNameChoice
);

Параметры

[in] DistPointIndex

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

[in] NameIndex

Указывает индекс получаемой записи выбора имени. Первое значение равно нулю индекса.

[out] pNameChoice

Указатель на объект Long , представляющий выбор имени.

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

C++

Если метод выполнен успешно, метод возвращает S_OK.

Если метод завершается сбоем, он возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

VB

Возвращаемое значение — это выбор имени по указанному индексу. Выбор имени указывает тип имени, чтобы его можно было использовать правильно. Выбор имени должен быть одним из следующих значений.

Код возврата	Описание
CERT_ALT_NAME_RFC822_NAME	Имя — это адрес электронной почты.
CERT_ALT_NAME_DNS_NAME	Имя — это строка IA5, содержащая DNS-имя (система доменных имен) в формате Host.Сущность.Домен.
CERT_ALT_NAME_URL	Имя — это строка IA5, содержащая URL-адрес в формате Service://HostName/Path.
CERT_ALT_NAME_REGISTERED_ID	Имя является зарегистрированным идентификатором объекта (OID).

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	certenc.h (включая Certsrv.h)
Библиотека	Certidl.lib
DLL	Certenc.dll

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

ICertEncodeCRLDistInfo

ICertEncodeCRLDistInfo::SetNameEntry

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