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


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

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

Синтаксис

HRESULT GetName(
  [in]  LONG NameIndex,
  [out] BSTR *pstrName
);

Параметры

[in] NameIndex

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

Чтобы получить идентификатор объекта (OID) имени CERT_ALT_NAME_OTHER_NAME, объедините значение индекса с EAN_NAMEOBJECTID (определяется как 0x80000000) с побитовой операцией ИЛИ . В противном случае извлекается двоичное значение. Чтобы определить тип имени, вызовите метод ICertEncodeAltName::GetNameChoice .

[out] pstrName

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

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

C++

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

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

VB

Возвращаемое значение — это альтернативное имя по указанному индексу. Возвращаемое значение представляет собой строку Юникода .

Требования

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

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

ICertEncodeAltName

ICertEncodeAltName::GetNameChoice

ICertEncodeAltName::SetNameEntry