Método IAlternativeName::InitializeFromString (certenroll.h)

  • Artículo

El método InitializeFromString inicializa el objeto a partir de una cadena que contiene una dirección de correo electrónico, un nombre del Sistema de nombres de dominio (DNS), una dirección URL, un identificador de objeto registrado (OID) o un nombre principal de usuario (UPN).

Sintaxis

HRESULT InitializeFromString(
  [in] AlternativeNameType Type,
  [in] BSTR                strValue
);

Parámetros

[in] Type

Valor de enumeración AlternativeNameType que identifica el tipo de nombre representado por la cadena de entrada contenida en el parámetro strValue . Debe ser uno de los valores siguientes.

Valor Significado
XCN_CERT_ALT_NAME_RFC822_NAME
 El nombre es una dirección de correo electrónico.
XCN_CERT_ALT_NAME_DNS_NAME
 El nombre es un nombre DNS.
XCN_CERT_ALT_NAME_URL
 El nombre es una dirección URL.
XCN_CERT_ALT_NAME_REGISTERED_ID
 El nombre es un OID registrado.
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME
 El nombre es un UPN.

[in] strValue

Variable BSTR que contiene el nombre.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

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

Comentarios

Si usa este método para especificar un UPN, el UPN se asocia con el OID de XCN_OID_NT_PRINCIPAL_NAME (1.3.6.1.4.1.311.20.2.3) y está codificado reglas de codificación distinguida (DER). Puede llamar a la propiedad RawData para recuperar la matriz de bytes codificada. Puede recuperar el OID llamando a la propiedad ObjectId .

Si usa este método para especificar cualquiera de los siguientes tipos de nombre, el método devuelve E_INVALIDARG.

Valor Descripción
XCN_CERT_ALT_NAME_UNKNOWN No se identifica el tipo de nombre.
XCN_CERT_ALT_NAME_OTHER_NAME El nombre consta de un OID y una matriz de bytes.
XCN_CERT_ALT_NAME_DIRECTORY_NAME El nombre es un nombre de directorio X.500 .
XCN_CERT_ALT_NAME_IP_ADDRESS El nombre es una dirección IP.
XCN_CERT_ALT_NAME_GUID El nombre es un GUID.
 

Puede usar el método InitializeFromOtherName para especificar un OID y una cadena de nombre correspondiente, y puede usar el método InitializeFromRawData para especificar un GUID, una dirección IP o un nombre de directorio X.500.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certenroll.h
Archivo DLL CertEnroll.dll

Consulte también

IAlternativeName

IAlternativeNames

IX509ExtensionAlternativeNames