Método ICertEncodeAltName::GetName (certenc.h)
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 |