ICertRequest3 ::GetIssuedCertificate2, méthode (certcli.h)

Article
08/22/2023

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

Syntaxe

HRESULT GetIssuedCertificate2(
  [in]          BSTR strConfig,
  [in]          BSTR strRequestId,
  [in]          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] strRequestId

Valeur BSTR qui représente l’ID de demande de certificat dans la base de données Certificates Services. Définissez ce paramètre sur NULL si le numéro de série (passé en tant que strSerialNumber) doit être utilisé à la place de l’ID de requête.

Utilisez la méthode ICertRequest3 ::GetRequestIdString pour obtenir la chaîne d’ID de requête.

[in] strSerialNumber

Valeur BSTR qui représente le numéro de série du certificat, tel qu’émis par l’autorité de certification. La chaîne doit spécifier le numéro de série en tant que nombre pair de chiffres hexadécimaux. Si nécessaire, un zéro peut être préfixé au nombre pour produire un nombre pair de chiffres. Toutefois, il est possible d’utiliser plus d’un zéro de début.

La valeur strSerialNumber est utilisée uniquement lorsque le strRequestId a la valeur NULL.

[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 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certcli.h (inclure Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certcli.dll

Voir aussi

CCertRequest

ICertRequest3