Metodo IAlternativeName::InitializeFromRawData (certenroll.h)

Articolo
08/22/2023

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.

Valore	Significato
XCN_CERT_ALT_NAME_DIRECTORY_NAME	Il nome è un nome di directory X.500.
XCN_CERT_ALT_NAME_IP_ADDRESS	Il nome è un indirizzo IP.
XCN_CERT_ALT_NAME_GUID	Il nome è un GUID.

[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.

Codice restituito	Descrizione
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	L'oggetto è già inizializzato.

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.

Valore	Descrizione
XCN_CERT_ALT_NAME_UNKNOWN	Il tipo di nome non è identificato.
XCN_CERT_ALT_NAME_RFC822_NAME	Il nome è un indirizzo di posta elettronica.
XCN_CERT_ALT_NAME_DNS_NAME	Il nome è un nome DNS.
XCN_CERT_ALT_NAME_URL	Il nome è un URL.
XCN_CERT_ALT_NAME_REGISTERED_ID	Il nome è un OID registrato.
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME	Il nome è un nome dell'entità utente (UPN).
XCN_CERT_ALT_NAME_OTHER_NAME	Il nome è costituito da un OID e da una matrice di byte.

È 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

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certenroll.h
DLL	CertEnroll.dll

Vedi anche

IAlternativeName