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

O método InitializeFromOtherName inicializa o objeto de um OID (identificador de objeto ) e os dados brutos associados (matriz de bytes). Esse método é fornecido para dar suporte ao campo otherName na declaração de extensão AsN.1 ( Abstract Syntax Notation One ) AlternativeNames .

----------------------------------------------------------------------
-- 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 
}

Sintaxe

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

Parâmetros

[in] pObjectId

Ponteiro para uma interface IObjectId que representa um OID.

[in] Encoding

Um valor de enumeração EncodingType que identifica o tipo de codificação Unicode aplicada ao parâmetro strRawData .

[in] strRawData

Uma variável BSTR que contém o nome associado à OID.

[in] ToBeWrapped

Uma variável VARIANT_BOOL que identifica se a cadeia de caracteres de entrada contida no parâmetro strRawData é codificada e salva como uma cadeia de caracteres de octeto (matriz de bytes).

Valor de retorno

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT Comuns.

Observações

Você pode usar essa função para inicializar um objeto IAlternativeName de um OID e um valor de cadeia de caracteres associado. A cadeia de caracteres é codificada em Unicode. Se você especificar true para o parâmetro ToBeWrapped , a cadeia de caracteres será codificada usando DER (Distinguished Encoding Rules ). Você pode recuperar o OID chamando a propriedade ObjectId . Você pode recuperar a cadeia de caracteres codificada ou, se ToBeWrapped for true, a matriz de bytes codificada em DER chamando a propriedade RawData para recuperar a matriz de bytes codificada.

Requirements

Consulte também

IAlternativeName