Metodo IObjectId::InitializeFromName (certenroll.h)
Il metodo InitializeFromName inizializza l'oggetto da un valore di enumerazione CERTENROLL_OBJECTID. Questo metodo è abilitato per il Web.
Sintassi
HRESULT InitializeFromName(
[in] CERTENROLL_OBJECTID Name
);
Parametri
[in] Name
Valore di enumerazione CERTENROLL_OBJECTID.
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/valore restituito | Descrizione |
|---|---|
|
Impossibile trovare le informazioni OID. |
|
Il nome dell'algoritmo non viene riconosciuto. |
|
L'oggetto è già inizializzato. |
Commenti
Ogni valore CERTENROLL_OBJECTID è associato a un identificatore di oggetto ASN.1. Ad esempio, il valore XCN_OID_ECDSA_SHA1 è associato a una stringa contenente 1.2.840.10045.4.1. Si tratta della rappresentazione decimale punteggiata dell'identificatore dell'oggetto iso(1)member-body(2)us(840)10045 signatures(4)sha1(1).
Il metodo InitializeFromName cerca nel Registro di sistema informazioni associate all'identificatore di oggetto ASN.1. Se vengono trovate informazioni, il metodo popola internamente una struttura CRYPT_OID_INFO e la associa all'oggetto . Il metodo utilizza anche le informazioni locali per inizializzare, se possibile, il nome visualizzato dell'oggetto.
È possibile chiamare le proprietà seguenti per recuperare informazioni su un oggetto IObjectId inizializzato:
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 |