Metodo IAlternativeName::InitializeFromOtherName (certenroll.h)

Il metodo InitializeFromOtherName inizializza l'oggetto da un identificatore di oggetto (OID) e dai dati non elaborati associati (matrice di byte). Questo metodo viene fornito per supportare il campo otherName nella dichiarazione di estensione Abstract Syntax Notation One (ASN.1) 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 
}

Sintassi

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

Parametri

[in] pObjectId

Puntatore a un'interfaccia IObjectId che rappresenta un OID.

[in] Encoding

Valore di enumerazione EncodingType che identifica il tipo di codifica Unicode applicato al parametro strRawData .

[in] strRawData

Variabile BSTR che contiene il nome associato all'OID.

[in] ToBeWrapped

Variabile VARIANT_BOOL che identifica se la stringa di input contenuta nel parametro strRawData viene codificata e salvata come stringa ottetto (matrice di byte).

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. I valori possibili includono, ma non solo, quelli nella tabella seguente. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Osservazioni:

È possibile usare questa funzione per inizializzare un oggetto IAlternativeName da un OID e da un valore stringa associato. La stringa è codificata in Unicode. Se si specifica true per il parametro ToBeWrapped , la stringa viene codificata usando le regole di codifica distinte (DER). È possibile recuperare l'OID chiamando la proprietà ObjectId . È possibile recuperare la stringa codificata oppure, se ToBeWrapped è true, la matrice di byte con codifica DER chiamando la proprietà RawData per recuperare la matrice di byte codificata.

Requisiti

Vedere anche

IAlternativeName