estrutura CTL_VERIFY_USAGE_STATUS (wincrypt.h)

A estrutura CTL_VERIFY_USAGE_STATUS contém informações sobre uma CTL ( Lista de Certificados Confiáveis ) retornada por CertVerifyCTLUsage.

Sintaxe

typedef struct _CTL_VERIFY_USAGE_STATUS {
  DWORD          cbSize;
  DWORD          dwError;
  DWORD          dwFlags;
  PCCTL_CONTEXT  *ppCtl;
  DWORD          dwCtlEntryIndex;
  PCCERT_CONTEXT *ppSigner;
  DWORD          dwSignerIndex;
} CTL_VERIFY_USAGE_STATUS, *PCTL_VERIFY_USAGE_STATUS;

Membros

cbSize

Especifica o tamanho, em bytes, da estrutura. O aplicativo que chama CertVerifyCTLUsage define esse parâmetro. Se cbSize não for maior ou igual ao tamanho necessário da estrutura, CertVerifyCTLUsage retornará FALSE e GetLastError retornará E_INVALIDARG.

dwError

O erro status, se houver, retornado pela chamada para CertVerifyCTLUsage. Para obter a lista de possíveis valores de erro, consulte a seção Valores retornados em CertVerifyCTLUsage.

dwFlags

Se CERT_VERIFY_UPDATED_CTL_FLAG for retornado, CertVerifyCTLUsage atualizará uma CTL cujo tempo não era mais válido com uma nova CTL válida por tempo.

ppCtl

Ponteiro para um ponteiro para um contexto CTL que contém o assunto correspondente. O aplicativo de chamada pode definir esse ponteiro como NULL para indicar que uma CTL que contém o assunto não deve ser retornada.

Se ppCtl não for NULL, o aplicativo de chamada deverá liberar o contexto retornado usando CertFreeCTLContext.

dwCtlEntryIndex

Retorna o local da matriz da entrada da entidade correspondente na matriz da CTL.

ppSigner

Um ponteiro para um ponteiro para o contexto de certificado do signatário da CTL. Esse ponteiro pode ser definido como NULL pelo aplicativo de chamada indicando que o certificado do signatário da CTL não deve ser retornado.

Se ppSigner não for NULL, o aplicativo de chamada deverá liberar o contexto retornado usando CertFreeCTLContext.

dwSignerIndex

Índice do signatário realmente usado. Necessário se uma mensagem tiver mais de um signatário.

Comentários

Os membros dwError, dwFlags, dwCtlEntryIndex e dwSignerIndex devem ser inicializados como zero pelo aplicativo de chamada.

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

CERT_CONTEXT

CTL_CONTEXT

CertVerifyCTLUsage