Metodo IAlternativeName::InitializeFromString (certenroll.h)

  • Articolo

Il metodo InitializeFromString inizializza l'oggetto da una stringa che contiene un indirizzo di posta elettronica, un nome DNS (Domain Name System), un URL, un identificatore di oggetto registrato (OID) o un nome dell'entità utente (UPN).

Sintassi

HRESULT InitializeFromString(
  [in] AlternativeNameType Type,
  [in] BSTR                strValue
);

Parametri

[in] Type

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

Valore Significato
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 UPN.

[in] strValue

Variabile BSTR che contiene il nome.

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. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Se si usa questo metodo per specificare un UPN, l'UPN è associato all'OID XCN_OID_NT_PRINCIPAL_NAME (1.3.6.1.4.1.311.20.2.3) e viene codificato Distinguished Encoding Rules (DER). È possibile chiamare la proprietà RawData per recuperare la matrice di byte codificata. È possibile recuperare l'OID chiamando la proprietà ObjectId .

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_OTHER_NAME Il nome è costituito da un OID e da una matrice di byte.
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.
 

È possibile utilizzare il metodo InitializeFromOtherName per specificare un OID e una stringa di nome corrispondente ed è possibile utilizzare il metodo InitializeFromRawData per specificare un GUID, un indirizzo IP o un nome di directory X.500.

Requisiti

   
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

IAlternativeNames

IX509ExtensionAlternativeNames