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

Статья
08/22/2023

Метод GetNameChoice возвращает выбор имени по указанному индексу альтернативного массива имен.

Синтаксис

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

Параметры

[in] NameIndex

Указывает индекс записи альтернативного имени. Первая запись находится на нулевом индексе.

[out] pNameChoice

Указатель на объект LONG , который получает описатель выбора имени.

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

C++

Если метод выполнен успешно, метод возвращает S_OK, а параметр pNameChoice указывает на значение, указывающее тип альтернативного имени. Это одно из следующих значений.

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

VB

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

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

Требования

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

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

ICertEncodeAltName

ICertEncodeAltName::GetName

ICertEncodeAltName::SetNameEntry

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