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
);

Die 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ögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt. Eine Liste allgemeiner Fehlercodes finden Sie unter "Allgemeine HRESULT-Werte".

Zurückgeben von Code/Wert Description
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 wurde bereits initialisiert.

Bemerkungen

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

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 außerdem die lokalen Informationen, um ggf. den Anzeigenamen des Objekts zu initialisieren.

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

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 [Nur Desktop-Apps]
Zielplattform Fenster
Header certenroll.h
DLL CertEnroll.dll

Siehe auch

FriendlyName

IObjectID