Partager via

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

  • Article

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