Compartilhar via


Função CertGetServerOcspResponseContext (wincrypt.h)

A função CertGetServerOcspResponseContext recupera um contexto de resposta OCSP (certificado online status) não bloqueado e válido por tempo para o identificador especificado.

Sintaxe

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

Parâmetros

[in] hServerOcspResponse

O identificador de resposta do servidor OCSP para o qual recuperar um contexto de resposta. Esse identificador é retornado pela função CertOpenServerOcspResponse .

[in] dwFlags

Esse parâmetro é reservado para uso futuro e deve ser zero.

pvReserved

Esse parâmetro é reservado para uso futuro e deve ser NULL.

Valor retornado

Se a função for bem-sucedida, ela retornará um ponteiro para uma estrutura CERT_SERVER_OCSP_RESPONSE_CONTEXT .

Para que uma resposta seja válida por tempo, a hora atual no sistema que hospeda essa chamada de função deve ser menor do que a próxima hora de atualização para o contexto da CRL ( lista de revogação de certificados ). Quando uma resposta OCSP válida por tempo não estiver disponível, essa função retornará NULL com o último erro definido como CRYPT_E_REVOCATION_OFFLINE.

Se o certificado for desconhecido pelo respondente OCSP, essa função retornará NULL com o último erro definido como CRYPT_E_REVOCATION_OFFLINE.

Comentários

Se você usar a função CertGetServerOcspResponseContext para criar várias referências a um contexto de resposta OCSP, deverá chamar CertAddRefServerOcspResponseContext para incrementar a contagem de referência para a estrutura CERT_SERVER_OCSP_RESPONSE_CONTEXT . Quando terminar de usar a estrutura, você deverá liberá-la chamando a função CertFreeServerOcspResponseContext .

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wincrypt.h
Biblioteca Crypt32.lib
DLL Crypt32.dll