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

Статья
08/22/2023

Метод SetNameEntry задает имя по указанному индексу альтернативного массива имен.

Перед использованием этого метода необходимо вызвать ICertEncodeAltName::Reset , чтобы объект знал, сколько элементов в массиве.

Синтаксис

HRESULT SetNameEntry(
  [in] LONG       NameIndex,
  [in] LONG       NameChoice,
  [in] const BSTR strName
);

Параметры

[in] NameIndex

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

Если параметр NameChoice имеет значение CERT_ALT_NAME_OTHER_NAME, ИЛИ (|) значение индекса с EAN_NAMEOBJECTID (определяется как 0x80000000), чтобы задать OID. В противном случае устанавливается двоичное значение.

[in] NameChoice

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

Значение	Значение
CERT_ALT_NAME_DIRECTORY_NAME	Это имя каталога.
CERT_ALT_NAME_DNS_NAME	Имя представляет собой строку IA5, указывающую DNS-имя (имя системы доменных имен) в формате host.entity.domain.
CERT_ALT_NAME_IP_ADDRESS	Имя представляет собой строку октета, представляющую ip-адрес протокола.
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-объекта.

[in] strName

Задает альтернативное имя.

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

VB

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

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

Требования

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

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

ICertEncodeAltName

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