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 |
---|---|
|
El nombre es un nombre de directorio. |
|
El nombre es una cadena IA5 que especifica un nombre DNS (sistema de nombres de dominio) en el formato host.entity.domain. |
|
El nombre es una cadena de octeto que representa una dirección de protocolo de Internet. |
|
El nombre es un identificador de objeto registrado (OID). |
|
El nombre es una dirección de correo electrónico. |
|
El nombre es una cadena IA5 que contiene una dirección URL con el formato Service://HostName/Path. |
|
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 |