Fonction CertGetServerOcspResponseContext (wincrypt.h)

  • Article

La fonction CertGetServerOcspResponseContext récupère un contexte de réponse de certificat en ligne status protocole (OCSP) non bloquant et valide pour le handle spécifié.

Syntaxe

PCCERT_SERVER_OCSP_RESPONSE_CONTEXT CertGetServerOcspResponseContext(
  [in] HCERT_SERVER_OCSP_RESPONSE hServerOcspResponse,
  [in] DWORD                      dwFlags,
       LPVOID                     pvReserved
);

Paramètres

[in] hServerOcspResponse

Handle de réponse du serveur OCSP pour lequel récupérer un contexte de réponse. Ce handle est retourné par la fonction CertOpenServerOcspResponse .

[in] dwFlags

Ce paramètre est réservé à une utilisation future et doit être égal à zéro.

pvReserved

Ce paramètre est réservé à une utilisation ultérieure et doit avoir la valeur NULL.

Valeur retournée

Si la fonction réussit, elle retourne un pointeur vers une structure CERT_SERVER_OCSP_RESPONSE_CONTEXT .

Pour qu’une réponse soit valide, l’heure actuelle sur le système hébergeant cet appel de fonction doit être inférieure à l’heure de mise à jour suivante pour le contexte de liste de révocation de certificats (CRL). Lorsqu’une réponse OCSP valide n’est pas disponible, cette fonction retourne null avec la dernière erreur définie sur CRYPT_E_REVOCATION_OFFLINE.

Si le certificat est inconnu par le répondeur OCSP, cette fonction retourne null avec le dernier paramètre d’erreur défini sur CRYPT_E_REVOCATION_OFFLINE.

Remarques

Si vous utilisez la fonction CertGetServerOcspResponseContext pour créer plusieurs références à un contexte de réponse OCSP, vous devez appeler CertAddRefServerOcspResponseContext pour incrémenter le nombre de références pour la structure CERT_SERVER_OCSP_RESPONSE_CONTEXT . Une fois la structure terminée, vous devez la libérer en appelant la fonction CertFreeServerOcspResponseContext .

Configuration requise

   
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 wincrypt.h
Bibliothèque Crypt32.lib
DLL Crypt32.dll