Partager via


IX509CertificateRequest ::ResetForEncode, méthode (certenroll.h)

La méthode ResetForEncode restaure l’état de l’objet de requête à celui qui existait avant l’appel de la méthode Encode .

Syntaxe

HRESULT ResetForEncode();

Valeur de retour

Si la fonction réussit, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles sont notamment celles figurant dans le tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Code/valeur de retour Description
CERTSRV_E_PROPERTY_EMPTY
Les extensions de certificat et les attributs n’ont pas été définis.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
L’objet de requête n’est pas encodé.
OLE_E_BLANK
L’objet n’est pas initialisé.

Remarques

Vous pouvez utiliser cette méthode pour reconfigurer (réencoder et re-signer) une demande de certificat en réponse au rejet de la demande par une autorité de certification. La signature et les données brutes sont effacées. Les extensions et les attributs sont réinitialisés aux valeurs qu’ils avaient avant l’appel de la méthode Encode , mais les indicateurs d’extension critiques ne le sont pas. Pour un objet de requête CMC, chaque requête imbriquée est également réinitialisée.

Cette méthode est généralement utilisée pour une demande d’archivage de clé CMC lorsque la clé privée est chiffrée et incluse dans la demande.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête certenroll.h
DLL CertEnroll.dll

Voir aussi

IX509CertificateRequest

IX509CertificateRequestCertificate

IX509CertificateRequestCmc

IX509CertificateRequestPkcs10

IX509CertificateRequestPkcs7

IX509SignatureInformation