Compartir a través de


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

El método SetNameEntry establece un nombre en un índice especificado de la matriz de nombres alternativos.

Antes de usar este método, debe llamar a ICertEncodeAltName::Reset para que el objeto sepa cuántos elementos hay en la matriz.

Sintaxis

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

Parámetros

[in] NameIndex

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

Si el parámetro NameChoice está CERT_ALT_NAME_OTHER_NAME, OR (|) el valor de índice con EAN_NAMEOBJECTID (definido como 0x80000000) para establecer el OID. De lo contrario, se establece el valor binario.

[in] NameChoice

Especifica la opción de nombre. La opción de nombre indica el tipo del nombre alternativo para que se pueda usar correctamente. Debe tener uno de los siguientes valores.

Valor Significado
CERT_ALT_NAME_DIRECTORY_NAME
El nombre es un nombre de directorio.
CERT_ALT_NAME_DNS_NAME
El nombre es una cadena IA5 que especifica un nombre DNS (sistema de nombres de dominio) en el formato host.entity.domain.
CERT_ALT_NAME_IP_ADDRESS
El nombre es una cadena de octeto 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 identificador de objeto (OID) y un BLOB binario.

[in] strName

Especifica el nombre alternativo.

Valor devuelto

VB

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.

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