IX509Enrollment::Enroll-Methode (certenroll.h)

  • Artikel

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ögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Rückgabecode/-wert BESCHREIBUNG
OLE_E_BLANK
 Das Registrierungsobjekt wurde nicht initialisiert.

Hinweise

Die -Methode kann bei Bedarf ein Schlüsselpaar erstellen. Je nachdem, wie Sie das Registrierungsobjekt initialisieren und welche Eigenschaften Sie festlegen, ist es möglicherweise nicht erforderlich, ein Schlüsselpaar zu erstellen. Wenn Sie z. B. ein Zertifikat mit einem vorhandenen Schlüssel erneuern 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 die Registrierung status zu bestimmen.

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

IX509Registrierung