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