Compartir a través de

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

  • Artículo

El método InitializeFromRawData inicializa el objeto a partir de un GUID de algoritmo de firma digital (DSA), un nombre de directorio X.500 o una dirección de protocolo de Internet (IP) contenida en una matriz de bytes codificada reglas de codificación distinguida (DER).

Sintaxis

HRESULT InitializeFromRawData(
  [in] AlternativeNameType Type,
  [in] EncodingType        Encoding,
  [in] BSTR                strRawData
);

Parámetros

[in] Type

Valor de enumeración AlternativeNameType que identifica el tipo de nombre representado por la cadena de entrada. Debe ser uno de los siguientes valores.

Valor Significado
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.

[in] Encoding

Valor de enumeración EncodingType que identifica el tipo de codificación Unicode aplicada al parámetro strRawData .

[in] strRawData

Variable BSTR que contiene los datos codificados por DER.

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. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código devuelto Descripción
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 El objeto ya se ha inicializado.

Comentarios

Los datos sin procesar son una matriz de bytes que se ha codificado mediante reglas de codificación distinguida (DER). Debe especificar la matriz de bytes como una cadena codificada unicode.

Si usa este método para especificar un GUID de DSA (XCN_CERT_ALT_NAME_GUID), el GUID se asocia a la XCN_OID_NTDS_REPLICATION (1.3.6.1.4.1.311.25.1 ) y se codifica como una cadena de octeto (matriz de bytes). Puede recuperar el OID llamando a la propiedad ObjectId . Puede llamar a la propiedad RawData para recuperar la matriz de bytes codificada.

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 El tipo de nombre no se identifica.
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 nombre principal de usuario (UPN).
XCN_CERT_ALT_NAME_OTHER_NAME El nombre consta de un OID y una matriz de bytes.
 

Puede usar el método InitializeFromOtherName para especificar un OID y una cadena de nombre correspondiente, y puede usar el método InitializeFromString para especificar una dirección de correo electrónico, un nombre DNS, una dirección URL, un OID registrado o un nombre principal de usuario (UPN).

Requisitos

Requisito Value
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