Compartir a través de

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

  • Artículo

El método InitializeFromOtherName inicializa el objeto a partir de un identificador de objeto (OID) y los datos sin procesar asociados (matriz de bytes). Este método se proporciona para admitir el campo otherName en la declaración de extensión AlternativeNamesde notación de sintaxis abstracta uno (ASN.1).


----------------------------------------------------------------------
-- AlternativeNames 
-- XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17)
----------------------------------------------------------------------

AltNames ::= SEQUENCE --#public-- OF GeneralName
GeneralNames ::= AltNames

GeneralName ::= CHOICE 
{
   otherName               [0] IMPLICIT OtherName,
   rfc822Name              [1] IMPLICIT IA5STRING,
   dNSName                 [2] IMPLICIT IA5STRING,
   x400Address             [3] IMPLICIT SeqOfAny,       -- Not supported
   directoryName           [4] EXPLICIT ANY,    
   ediPartyName            [5] IMPLICIT SeqOfAny,
   uniformResourceLocator  [6] IMPLICIT IA5STRING,
   iPAddress               [7] IMPLICIT OCTETSTRING,
   registeredID            [8] IMPLICIT EncodedObjectID -- Not supported
}

OtherName ::= SEQUENCE 
{
   type                    EncodedObjectID,
   value                   [0] EXPLICIT NOCOPYANY 
}

Sintaxis

HRESULT InitializeFromOtherName(
  [in] IObjectId    *pObjectId,
  [in] EncodingType Encoding,
  [in] BSTR         strRawData,
  [in] VARIANT_BOOL ToBeWrapped
);

Parámetros

[in] pObjectId

Puntero a una interfaz IObjectId que representa un OID.

[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 el nombre asociado al OID.

[in] ToBeWrapped

Variable VARIANT_BOOL que identifica si la cadena de entrada contenida en el parámetro strRawData está codificada y guardada como una cadena de octetos (matriz de bytes).

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 o valor devuelto Descripción
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 El objeto ya se ha inicializado.

Comentarios

Puede usar esta función para inicializar un objeto IAlternativeName desde un OID y un valor de cadena asociado. La cadena tiene codificación Unicode. Si especifica true para el parámetro ToBeWrapped, la cadena se codifica mediante reglas de codificación distinguida (DER). Puede recuperar el OID llamando a la propiedad ObjectId . Puede recuperar la cadena codificada o, si ToBeWrapped es true, la matriz de bytes codificada por DER llamando a la propiedad RawData para recuperar la matriz de bytes codificada.

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