Método ICertEncodeAltName::GetName (certenc.h)

  • Artículo

El método GetName devuelve el nombre especificado de la matriz de nombres alternativo.

Sintaxis

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

Parámetros

[in] NameIndex

Índice de base cero que especifica el índice de la entrada de nombre alternativa que se va a recuperar.

Para recuperar el identificador de objeto (OID) de un nombre de CERT_ALT_NAME_OTHER_NAME, combine el valor de índice con EAN_NAMEOBJECTID (definido como 0x80000000) con una operación OR bit a bit. De lo contrario, se recupera el valor binario. Para determinar el tipo de nombre, llame al método ICertEncodeAltName::GetNameChoice .

[out] pstrName

Puntero a un BSTR que recibe el nombre alternativo. Cuando haya terminado de usar el BSTR, áurelo llamando a la función SysFreeString .

Valor devuelto

C++

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

VB

El valor devuelto es el nombre alternativo en el índice especificado. El valor devuelto es una cadena Unicode .

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certenc.h (incluya Certsrv.h)
Library Certidl.lib
Archivo DLL Certenc.dll

Consulte también

ICertEncodeAltName

ICertEncodeAltName::GetNameChoice

ICertEncodeAltName::SetNameEntry