Freigeben über


IX509CertificateRequest::ResetForEncode-Methode (certenroll.h)

Die ResetForEncode-Methode stellt den Zustand des Anforderungsobjekts auf den Zustand wieder her, der vor dem Aufruf der Encode-Methode vorhanden war.

Syntax

HRESULT ResetForEncode();

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/-wert BESCHREIBUNG
CERTSRV_E_PROPERTY_EMPTY
Zertifikaterweiterungen und -attribute wurden nicht definiert.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
Das Anforderungsobjekt ist nicht codiert.
OLE_E_BLANK
Das Objekt wird nicht initialisiert.

Hinweise

Mit dieser Methode können Sie eine Zertifikatanforderung als Antwort auf die Ablehnung der Anforderung durch eine Zertifizierungsstelle neu konfigurieren (neu codieren und neu signieren). Die Signatur und die Rohdaten werden gelöscht. Die Erweiterungen und Attribute werden auf die Werte zurückgesetzt, die sie vor dem Aufruf der Codierungsmethode hatten, kritische Erweiterungsflags jedoch nicht. Bei einem CMC-Anforderungsobjekt wird jede geschachtelte Anforderung ebenfalls zurückgesetzt.

Diese Methode wird in der Regel für eine CMC-Schlüsselarchivanforderung verwendet, wenn der private Schlüssel verschlüsselt und in der Anforderung enthalten ist.

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

IX509CertificateRequest

IX509CertificateRequestCertificate

IX509CertificateRequestCmc

IX509CertificateRequestPkcs10

IX509CertificateRequestPkcs7

IX509SignatureInformation