IX509CertificateRequest::Initialize-Methode (certenroll.h)
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.
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 |
|---|---|
|
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 |