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

El método GetNameChoice devuelve la opción de nombre en un índice especificado de una matriz de nombres alternativa.

Sintaxis

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

Parámetros

[in] NameIndex

Especifica el índice de la entrada de nombre alternativa. La primera entrada está en el índice cero.

[out] pNameChoice

Puntero a un long que recibe el especificador de elección de nombre.

Valor devuelto

C++

Si el método se ejecuta correctamente, el método devuelve S_OK y el parámetro pNameChoice apunta a un valor que indica el tipo del nombre alternativo. Este es uno de los siguientes valores.

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 la opción de nombre en el índice especificado. La opción de nombre indica el tipo del nombre alternativo para que se pueda usar correctamente. Debe tener uno de los siguientes valores.

Código devuelto	Descripción
CERT_ALT_NAME_DIRECTORY_NAME	El nombre es un nombre de directorio.
CERT_ALT_NAME_DNS_NAME	El nombre es una cadena IA5 que contiene un nombre DNS (sistema de nombres de dominio) con el formato Host.Entidad.Dominio.
CERT_ALT_NAME_IP_ADDRESS	El nombre es una cadena de octetos que representa una dirección de protocolo de Internet.
CERT_ALT_NAME_REGISTERED_ID	El nombre es un identificador de objeto registrado (OID).
CERT_ALT_NAME_RFC822_NAME	El nombre es una dirección de correo electrónico.
CERT_ALT_NAME_URL	El nombre es una cadena IA5 que contiene una dirección URL con el formato Service://HostName/Path.
CERT_ALT_NAME_OTHER_NAME	El nombre consta de un OID y un BLOB binario.

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::GetName

ICertEncodeAltName::SetNameEntry