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ö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 |
|---|---|
|
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 |