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 |