IX509CertificateRequest::Initialize-Methode (certenroll.h)

Artikel
02/28/2024

Die Initialize-Methode initialisiert das Anforderungsobjekt für einen Benutzer oder computer.

Syntax

HRESULT Initialize(
  [in] X509CertificateEnrollmentContext Context
);

Parameter

[in] Context

Ein X509CertificateEnrollmentContext-Enumerationswert , der angibt, ob das Zertifikat für einen Endbenutzer, einen Computer oder einen Administrator bestimmt ist, der im Auftrag eines Computers agiert. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
ContextUser	Das Zertifikat wird für einen Endbenutzer angefordert.
ContextMachine	Das Zertifikat wird für einen Computer angefordert.
ContextAdministratorForceMachine	Das Zertifikat wird von einem Administrator angefordert, der im Namen eines Computers handelt.

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	Beschreibung
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Das Objekt ist bereits initialisiert.

Hinweise

Die Initialize-Methode initialisiert verschiedene Objekte abhängig vom Typ der erstellten Zertifikatanforderung. Wenn Sie diese Methode aus einem IX509CertificateRequestPkcs10-Objekt aufrufen, wird ein Private Key-Objekt erstellt, und die folgenden Objekte werden initialisiert:

Eine leere ICryptAttributes-Auflistung .
Eine leere IX509Extensions-Auflistung .
Eine IObjectIds-Auflistung , die die standardmäßigen bezeichner für kritische Erweiterungsobjekte enthält, XCN_OID_KEY_USAGE und XCN_OID_BASIC_CONSTRAINTS2. Diese Auflistung kann durch Aufrufen der CriticalExtensions-Eigenschaft abgerufen werden.
Eine leere IObjectIds-Auflistung für die SuppressOids-Eigenschaft .
Ein ICspInformations-Objekt , das die Werte enthält, die Sie in der CSPInformations-Eigenschaft angegeben haben , oder eine Auflistung aller anbieter, die auf dem Computer installiert sind. Diese Sammlung wird verwendet, um einen privaten Schlüssel zu erstellen.

Wenn Sie diese Methode aus einem IX509CertificateRequestCmc-Objekt aufrufen, wird wie oben eine innere PKCS #10-Anforderung erstellt, und die folgenden Objekte werden initialisiert:

Eine leere ICryptAttributes-Auflistung .
Eine leere IX509NameValuePairs-Auflistung .
Eine leere IX509Extensions-Auflistung .
Eine IObjectIds-Auflistung , die die standardmäßigen bezeichner für kritische Erweiterungsobjekte enthält, XCN_OID_KEY_USAGE und XCN_OID_BASIC_CONSTRAINTS2. Diese Auflistung kann durch Aufrufen der CriticalExtensions-Eigenschaft abgerufen werden.
Eine leere IObjectIds-Auflistung für die SuppressOids-Eigenschaft .
Eine leere ISignerCertificates-Auflistung .

Wenn Sie diese Methode aus einem IX509CertificateRequestPkcs7-Objekt aufrufen, wird wie oben eine innere PKCS #10-Anforderung erstellt.

Die folgenden Eigenschaften können aufgerufen werden, bevor Sie diese Methode aufrufen.

Sie müssen die CSPInformations-Eigenschaft aufrufen, bevor Sie diese Methode aufrufen, wenn Sie eine ICspInformations-Auflistung angeben möchten.

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