Freigeben über


IX509Enrollment::Enroll-Methode (certenroll.h)

Die "Enroll "-Methode codiert eine Anforderung, sendet sie an eine entsprechende Zertifizierungsstelle (Ca) und installiert die Antwort.

Syntax

HRESULT Enroll();

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
OLE_E_BLANK
Das Registrierungsobjekt wurde nicht initialisiert.

Bemerkungen

Die Methode kann bei Bedarf ein Schlüsselpaar erstellen. Je nachdem, wie Sie das Registrierungsobjekt initialisieren und welche Eigenschaften Sie festlegen, muss möglicherweise kein Schlüsselpaar erstellt werden. Wenn Sie beispielsweise ein Zertifikat mithilfe eines vorhandenen Schlüssels verlängern oder das ix509PrivateKey-Objekt , das der Zertifikatanforderung zugeordnet ist, einen vorhandenen Schlüssel darstellt, erstellt diese Methode kein neues Schlüsselpaar.

Vor der Registrierung müssen Sie das IX509Enrollment-Objekt initialisieren, indem Sie eine der folgenden Methoden aufrufen.

Wenn der Registrierungsvorgang erfolgreich ist, gibt die Funktion S_OK zurück. Dies bedeutet jedoch nicht unbedingt, dass die Antwort der Zertifizierungsstelle installiert wurde. Rufen Sie die Status-Eigenschaft auf, um den Registrierungsstatus zu ermitteln.

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

IX509Enrollment