Méthode ICertRequest2 ::GetIssuedCertificate (certcli.h)

Article
02/23/2024

La méthode GetIssuedCertificate récupère la disposition d’un certificat en spécifiant l’ID de demande ou le numéro de série du certificat.

Cette méthode est en fait identique à l’appel de ICertRequest3 ::RetrievePending, avec la possibilité supplémentaire de spécifier un numéro de série pour le certificat en question.

Syntaxe

HRESULT GetIssuedCertificate(
  [in]          const BSTR strConfig,
  [in]          LONG       RequestId,
  [in]          const BSTR strSerialNumber,
  [out, retval] LONG       *pDisposition
);

Paramètres

[in] strConfig

Représente une chaîne de configuration valide pour le serveur des services de certificats. La chaîne peut être une URL HTTPS pour un serveur d’inscription ou sous la forme ComputerName\CAName, où ComputerName est le nom du réseau du serveur et CAName est le nom commun de l’autorité de certification, comme entré lors de l’installation des services de certificats. Pour plus d’informations sur le nom de la chaîne de configuration, consultez ICertConfig.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Une URL HTTPS n’est pas prise en charge en tant qu’entrée.

[in] RequestId

Valeur LONG qui représente l’ID de demande de certificat dans la base de données Certificates Services. Utilisez –1 pour cette valeur si le numéro de série (passé en tant que strSerialNumber) doit être utilisé à la place de l’ID de demande.

[in] strSerialNumber

Valeur BSTR qui représente le numéro de série du certificat, tel qu’émis par l’autorité de certification. Pour que strSerialNumber soit utilisé, vous devez spécifier la valeur –1 pour RequestId.

[out, retval] pDisposition

Pointeur vers une valeur LONG qui représente la disposition du certificat. La disposition est l’une des valeurs suivantes.

Valeur	Signification
CR_DISP_DENIED	Demande refusée.
CR_DISP_ERROR	Échec de la requête.
CR_DISP_INCOMPLETE	La demande n’a pas été effectuée.
CR_DISP_ISSUED	Certificat émis.
CR_DISP_ISSUED_OUT_OF_BAND	Certificat émis séparément.
CR_DISP_UNDER_SUBMISSION	Demande effectuée en cours de soumission.

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

VB

La valeur de retour est une valeur De type Long qui représente la disposition du certificat.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certcli.h (inclure Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certcli.dll

Partager via