Freigeben über


IX509CertificateRequestPkcs10::InitializeFromPrivateKey-Methode (certenroll.h)

Die InitializeFromPrivateKey-Methode initialisiert die Zertifikatanforderung mithilfe eines IX509PrivateKey-Objekts und optional einer Vorlage. Diese Methode ist webfähig.

Syntax

HRESULT InitializeFromPrivateKey(
  [in]           X509CertificateEnrollmentContext Context,
  [in]           IX509PrivateKey                  *pPrivateKey,
  [in, optional] BSTR                             strTemplateName
);

Parameter

[in] Context

Ein X509CertificateEnrollmentContext-Enumerationswert , der angibt, ob das angeforderte Zertifikat für einen Endbenutzer, einen Computer oder einen Administrator bestimmt ist, der im Auftrag des Computers handelt. Dies kann einer der folgenden Werte sein. Wenn jedoch die MachineContext-Eigenschaft des privaten Schlüssels festgelegt ist, müssen Sie den ContextMachine-Enumerationswert angeben.

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 Auftrag eines Computers handelt.

[in] pPrivateKey

Zeiger auf eine IX509PrivateKey-Schnittstelle , die den privaten Schlüssel darstellt.

[in, optional] strTemplateName

Eine BSTR-Variable , die den allgemeinen Namen (Common Name, CN) der Vorlage enthält, wie er in Active Directory angezeigt wird, oder den dezimalen Objektbezeichner mit Punkt. Dies ist ein optionaler Parameter.

Rückgabewert

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

Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, 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 Zertifikatanforderungsobjekt wurde bereits initialisiert.

Hinweise

Wenn Sie eine Vorlage angeben, führt die InitializeFromPrivateKey-Methode die folgenden Aktionen aus:

Unabhängig davon, ob Sie eine Vorlage angeben oder nicht: Wenn die CSPInformations-Eigenschaft nicht angegeben ist, erstellt die Methode eine ICspInformations-Auflistung von den auf dem Computer installierten Anbietern.

An dieser Stelle wird kein privater Schlüssel erstellt. Wenn das an die Methode übergebene IX509PrivateKey-Objekt keinen vorhandenen Schlüssel darstellt, wird beim Aufrufen der Encode-Methode ein Schlüssel erstellt. Der Schlüssel wird mithilfe des Standardanbieters erstellt, wenn keine Vorlage angegeben wurde und die ProviderName-Eigenschaft für den IX509PrivateKey nicht festgelegt ist. Wenn ein privater Schlüssel vorhanden ist, wird er für die PrivateKey-Eigenschaft festgelegt.

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

IX509CertificateRequestPkcs10