Metodo IAlternativeName::InitializeFromString (certenroll.h)
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.
[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 |