ICertRequest3 ::GetIssuedCertificate2, méthode (certcli.h)
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.
HRESULT GetIssuedCertificate2(
[in] BSTR strConfig,
[in] BSTR strRequestId,
[in] BSTR strSerialNumber,
[out, retval] LONG *pDisposition
);
[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.
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.
La valeur de retour est une valeur De type Long qui représente la disposition du certificat.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 |