Funzione CertGetServerOcspResponseContext (wincrypt.h)

La funzione CertGetServerOcspResponseContext recupera un contesto di risposta del protocollo ocSP (Online Certificate Status Protocol ) valido per l'handle specificato.

Sintassi

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

Parametri

[in] hServerOcspResponse

Handle di risposta del server OCSP per il quale recuperare un contesto di risposta. Questo handle viene restituito dalla funzione CertOpenServerOcspResponse .

[in] dwFlags

Questo parametro è riservato per l'uso futuro e deve essere zero.

pvReserved

Questo parametro è riservato per l'uso futuro e deve essere NULL.

Valore restituito

Se la funzione ha esito positivo, restituisce un puntatore a una struttura CERT_SERVER_OCSP_RESPONSE_CONTEXT .

Per la validità della risposta, l'ora corrente nel sistema che ospita questa chiamata di funzione deve essere inferiore alla successiva ora di aggiornamento per il contesto CRL ( Certificate Revoche List ). Quando una risposta OCSP valida non è disponibile, questa funzione restituisce NULL con l'ultimo errore impostato su CRYPT_E_REVOCATION_OFFLINE.

Se il certificato è sconosciuto dal risponditore OCSP, questa funzione restituisce NULL con l'ultimo errore impostato su CRYPT_E_REVOCATION_OFFLINE.

Commenti

Se si usa la funzione CertGetServerOcspResponseContext per creare più riferimenti a un contesto di risposta OCSP, è necessario chiamare CertAddRefServerOcspResponseContext per incrementare il conteggio dei riferimenti per la struttura CERT_SERVER_OCSP_RESPONSE_CONTEXT . Al termine dell'uso della struttura, è necessario liberarlo chiamando la funzione CertFreeServerOcspResponseContext .

Requisiti