Freigeben über


IObjectId::InitializeFromName-Methode (certenroll.h)

Die InitializeFromName-Methode initialisiert das Objekt aus einem CERTENROLL_OBJECTID Enumerationswert. Diese Methode ist webfähig.

Syntax

HRESULT InitializeFromName(
  [in] CERTENROLL_OBJECTID Name
);

Parameter

[in] Name

Ein CERTENROLL_OBJECTID-Enumerationswert .

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Rückgabecode/-wert BESCHREIBUNG
CERTSRV_E_PROPERTY_EMPTY
Die OID-Informationen konnten nicht gefunden werden.
CRYPT_E_UNKNOWN_ALGO
Der Algorithmusname wird nicht erkannt.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
Das Objekt ist bereits initialisiert.

Hinweise

Jeder CERTENROLL_OBJECTID Wert ist einem ASN.1-Objektbezeichner zugeordnet. Beispielsweise ist der Wert XCN_OID_ECDSA_SHA1 einer Zeichenfolge zugeordnet, die 1.2.840.10045.4.1 enthält. Dies ist die gepunktete Dezimaldarstellung des Objektbezeichners iso(1)member-body(2)us(840)10045 signatures(4)sha1(1).

Die InitializeFromName-Methode durchsucht die Registrierung nach Informationen, die dem ASN.1-Objektbezeichner zugeordnet sind. Wenn Informationen gefunden werden, füllt die -Methode intern eine CRYPT_OID_INFO-Struktur auf und ordnet sie dem -Objekt zu. Die -Methode verwendet auch die lokalen Informationen, um nach Möglichkeit den Anzeigenamen des Objekts zu initialisieren.

Sie können die folgenden Eigenschaften aufrufen, um Informationen zu einem initialisierten IObjectId-Objekt abzurufen:

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile certenroll.h
DLL CertEnroll.dll

Weitere Informationen

Friendlyname

IObjectID