Método IAlternativeName::InitializeFromString (certenroll.h)
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.
[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 |