estrutura CERT_CHAIN_POLICY_STATUS (wincrypt.h)
A estrutura CERT_CHAIN_POLICY_STATUS contém a cadeia de certificados status informações retornadas pela função CertVerifyCertificateChainPolicy quando as cadeias de certificados são validadas.
Sintaxe
typedef struct _CERT_CHAIN_POLICY_STATUS {
DWORD cbSize;
DWORD dwError;
LONG lChainIndex;
LONG lElementIndex;
void *pvExtraPolicyStatus;
} CERT_CHAIN_POLICY_STATUS, *PCERT_CHAIN_POLICY_STATUS;
Membros
cbSize
O tamanho, em bytes, dessa estrutura.
dwError
Um valor que indica que um erro ou condição inválida foi encontrado durante o processo de validação. Os valores desse membro são específicos para o tipo de política, conforme especificado pelo valor do parâmetro pszPolicyOID da função CertVerifyCertificateChainPolicy .
Erros de política base (CERT_CHAIN_POLICY_BASE)
| Valor | Significado |
|---|---|
|
A assinatura do certificado não pode ser verificada. |
|
O certificado ou assinatura foi revogado. |
|
Uma cadeia de certificação processada corretamente, mas encerrada em um certificado raiz que não é confiável pelo provedor de confiança. |
|
O certificado raiz é um certificado de teste e as configurações de política não permitem certificados de teste. |
|
Uma cadeia de certificados não foi criada corretamente. |
|
O certificado não é válido para o uso solicitado. |
|
Um certificado necessário não está dentro de seu período de validade. |
|
O certificado tem um nome inválido. O nome não está incluído na lista permitida ou é excluído explicitamente. |
|
O certificado tem uma política inválida. |
|
As restrições básicas do certificado não são válidas ou estão ausentes. |
|
O certificado está sendo usado para uma finalidade diferente da finalidade especificada por sua AC. |
|
Os períodos de validade da cadeia de certificação não aninham corretamente. |
|
A função de revogação não pôde marcar revogação do certificado. |
|
A função de revogação não pôde verificar a revogação porque o servidor de revogação estava offline. |
Erros básicos da política de restrições (CERT_CHAIN_POLICY_BASIC_CONSTRAINTS).
| Valor | Significado |
|---|---|
|
As restrições básicas do certificado não são válidas ou estão ausentes. |
Erros de política de autenticação (CERT_CHAIN_POLICY_AUTHENTICODE e CERT_CHAIN_POLICY_AUTHENTICODE_TS).
Esses erros são além dos erros de Política base.
Erros de política SSL (CERT_CHAIN_POLICY_SSL).
Esses erros são além dos erros de Política base.
| Valor | Significado |
|---|---|
|
Uma cadeia de certificação processada corretamente, mas encerrada em um certificado raiz que não é confiável pelo provedor de confiança. |
|
O nome CN do certificado não corresponde ao valor passado. |
|
O certificado está sendo usado para uma finalidade diferente das finalidades especificadas por sua AC. |
|
Um certificado que só pode ser usado como uma entidade final está sendo usado como uma AC ou vice-versa. |
Erros de Política Raiz da Microsoft (CERT_CHAIN_POLICY_MICROSOFT_ROOT).
| Valor | Significado |
|---|---|
|
Uma cadeia de certificação processada corretamente, mas encerrada em um certificado raiz que não é confiável pelo provedor de confiança. |
Erros de política de EV.
lChainIndex
Índice que indica a cadeia na qual um erro ou condição que não é válido foi encontrado. Para obter mais informações, consulte Comentários.
lElementIndex
Índice que indica o elemento em uma cadeia em que um erro ou condição que não é válido foi encontrado. Para obter mais informações, consulte Comentários.
pvExtraPolicyStatus
Um ponteiro para uma estrutura. O tipo de estrutura é determinado pelo valor do parâmetro pszPolicyOID da função CertVerifyCertificateChainPolicy . Além dos erros de dwError, as status extras específicas do OID de política também podem ser retornadas aqui para fornecer informações adicionais de status de cadeia. Opcionalmente, esse ponteiro pode ser definido para apontar para uma estrutura AUTHENTICODE_EXTRA_CERT_CHAIN_POLICY_STATUS .
Comentários
Se lChainIndex e lElementIndex estiverem definidos como –1, o erro ou a condição não válida se aplicará a todo o contexto de cadeia. Se somente lElementIndex for definido como –1, o erro ou condição que não é válido se aplicará à cadeia indexada por lChainIndex. Caso contrário, o erro ou a condição que não é válida se aplica ao elemento de certificado em pChainContext-rgpChain>[lChainIndex]->rgpElement[lElementIndex].
Requisitos
| 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 |