Metodo IObjectId::InitializeFromName (certenroll.h)

  • Articolo

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
CERTSRV_E_PROPERTY_EMPTY
 Impossibile trovare le informazioni OID.
CRYPT_E_UNKNOWN_ALGO
 Il nome dell'algoritmo non viene riconosciuto.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 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

Vedi anche

FriendlyName

IObjectID