estrutura CERT_REVOCATION_STATUS (wincrypt.h)

  • Artigo

A estrutura CERT_REVOCATION_STATUS contém informações sobre o status de revogação do certificado. Ele é passado para e retornado por CertVerifyRevocation. No retorno da função, ela especifica o status de um contexto revogado ou desmarcado.

Sintaxe

typedef struct _CERT_REVOCATION_STATUS {
  DWORD cbSize;
  DWORD dwIndex;
  DWORD dwError;
  DWORD dwReason;
  BOOL  fHasFreshnessTime;
  DWORD dwFreshnessTime;
} CERT_REVOCATION_STATUS, *PCERT_REVOCATION_STATUS;

Membros

cbSize

Tamanho dessa estrutura em bytes.

Após a entrada para CERT_REVOCATION_STATUS, cbSize deve ser definido como um tamanho maior ou igual ao tamanho de uma estrutura CERT_REVOCATION_STATUS . Caso contrário, CERT_REVOCATION_STATUS retornará FALSE e GetLastError retornará E_INVALIDARG.

dwIndex

Especifica um valor de índice para a matriz rgpvContext passada para CertVerifyRevocation. É o índice do primeiro contexto nessa matriz que foi revogado ou que não pôde ser verificado quanto à revogação. Para obter informações sobre os contextos que não foram verificados, CertVerifyRevocation é chamado novamente, especificando uma matriz rgpvContext que contém os contextos desmarcados da lista original.

dwError

Especifica o erro retornado status. Esse valor corresponde ao valor retornado de GetLastError no retorno da chamada para CertVerifyRevocation. Para obter a lista desses valores de erro, consulte a tabela na seção Valores retornados de CertVerifyRevocation.

dwReason

Especifica a causa do erro. Esse membro será definido somente se dwError for CRYPT_E_REVOKED. Ele contém um código que indica por que o contexto foi revogado. Pode ser um dos seguintes valores.

Valor Significado
CRL_REASON_UNSPECIFIED
 Nenhum motivo foi especificado para revogação.
CRL_REASON_KEY_COMPROMISE
 Sabe-se ou suspeita-se que a chave privada do assunto ou outros aspectos do assunto validado no certificado sejam comprometidos.
CRL_REASON_CA_COMPROMISE
 Sabe-se ou suspeita-se que a chave privada da AC ou outros aspectos da AC validados no certificado estão comprometidos.
CRL_REASON_AFFILIATION_CHANGED
 O nome da entidade ou outras informações no certificado foram modificadas, mas não há motivo para suspeitar que a chave privada foi comprometida.
CRL_REASON_SUPERSEDED
 O certificado foi substituído, mas não há motivo para suspeitar que a chave privada foi comprometida.
CRL_REASON_CESSATION_OF_OPERATION
 O certificado não é mais necessário para a finalidade para a qual foi emitido, mas não há motivo para suspeitar que a chave privada foi comprometida.
CRL_REASON_CERTIFICATE_HOLD
 O certificado foi colocado em espera.

fHasFreshnessTime

Dependendo do cbSize, essa estrutura pode conter esse membro. Se esse membro for TRUE, o tempo de atualização de revogação retornado por dwFreshnessTime será válido.

dwFreshnessTime

Dependendo do cbSize, essa estrutura pode conter esse membro. Se presente, esse membro fornece o tempo em segundos entre a hora atual e quando a CRL foi publicada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho wincrypt.h

Confira também

Certverifyrevocation