Metodo IX509ExtensionAlternativeNames::InitializeEncode (certenroll.h)

Il metodo InitializeEncode inizializza l'estensione da un insieme IAlternativeNames .

Sintassi

HRESULT InitializeEncode(
  [in] IAlternativeNames *pValue
);

Parametri

[in] pValue

Puntatore a un'interfaccia IAlternativeNames .

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 sono limitati a, quelli indicati nella tabella seguente. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Il metodo associa la raccolta dei nomi all'identificatore di oggetto (OID) XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17) e lo codifica usando Distinguished Encoding Rules (DER).

È necessario chiamare InitializeEncode o InitializeDecode prima di poter utilizzare un oggetto IX509ExtensionAlternativeNames . I due metodi si integrano tra loro. Il metodo InitializeEncode consente di costruire un oggetto di estensione ASN.1 ( Abstract Syntax Notation One ) con codifica DER dai dati non elaborati e il metodo InitializeDecode consente di inizializzare i dati non elaborati da un oggetto codificato.

È possibile recuperare le proprietà seguenti per questa estensione:

• La proprietà Critical identifica se l'estensione è critica. È anche possibile specificare questa proprietà.
• La proprietà ObjectId recupera l'OID.
• La proprietà AlternativeNames recupera la raccolta di nomi (dati di estensione non elaborati).

Requisiti

Vedi anche

IX509ExtensionAlternativeNames