Metodo IAlternativeName::InitializeFromRawData (certenroll.h)

Il metodo InitializeFromRawData inizializza l'oggetto da un GUID DSA (Digital Signature Algorithm), un nome di directory X.500 o un indirizzo IP (Internet Protocol) contenuto in una matrice di byte codificata Distinguished Encoding Rules (DER).

Sintassi

HRESULT InitializeFromRawData(
  [in] AlternativeNameType Type,
  [in] EncodingType        Encoding,
  [in] BSTR                strRawData
);

Parametri

[in] Type

Valore di enumerazione AlternativeNameType che identifica il tipo di nome rappresentato dalla stringa di input. Deve essere uno dei valori seguenti.

[in] Encoding

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

[in] strRawData

Variabile BSTR che contiene i dati con codifica DER.

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

I dati non elaborati sono una matrice di byte codificata tramite Distinguished Encoding Rules (DER). È necessario specificare la matrice di byte come stringa codificata Unicode.

Se si usa questo metodo per specificare un GUID DSA (XCN_CERT_ALT_NAME_GUID), il GUID è associato al XCN_OID_NTDS_REPLICATION (1.3.6.1.4.1.311.25.1) e codificato come stringa ottetto (matrice di byte). È possibile recuperare l'OID chiamando la proprietà ObjectId . È possibile chiamare la proprietà RawData per recuperare la matrice di byte codificata.

Se si utilizza questo metodo per specificare uno dei tipi di nome seguenti, il metodo restituisce E_INVALIDARG.

È possibile utilizzare il metodo InitializeFromOtherName per specificare un OID e una stringa di nome corrispondente ed è possibile utilizzare il metodo InitializeFromString per specificare un indirizzo di posta elettronica, un nome DNS, un URL, un OID registrato o un nome dell'entità utente (UPN).

Requisiti

Vedi anche

IAlternativeName