Freigeben über


IX509CertificateRequest::ResetForEncode-Methode (certenroll.h)

Die ResetForEncode-Methode stellt den Status des Anforderungsobjekts wieder her, das vorhanden war, bevor die Encode-Methode aufgerufen wurde.

Syntax

HRESULT ResetForEncode();

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

Bemerkungen

Mit dieser Methode können Sie eine Zertifikatanforderung als Reaktion auf Ablehnung der Anforderung durch eine Zertifizierungsstelle neu konfigurieren (neu codieren und erneut signieren). Die Signatur und die Rohdaten werden gelöscht. Die Erweiterungen und Attribute werden auf die Werte zurückgesetzt, die sie hatten, bevor die Encode-Methode aufgerufen wurde, aber kritische Erweiterungskennzeichnungen sind nicht. Für ein CMC-Anforderungsobjekt wird jede geschachtelte Anforderung ebenfalls zurückgesetzt.

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

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

IX509CertificateRequest

IX509CertificateRequestCertificate

IX509CertificateRequestCmc

IX509CertificateRequestPkcs10

IX509CertificateRequestPkcs7

IX509SignatureInformation