estrutura CRYPTUI_VIEWCERTIFICATE_STRUCTA (cryptuiapi.h)
A estrutura CRYPTUI_VIEWCERTIFICATE_STRUCT contém informações sobre um certificado a ser exibido. Essa estrutura é usada na função CryptUIDlgViewCertificate .
Sintaxe
typedef struct tagCRYPTUI_VIEWCERTIFICATE_STRUCTA {
DWORD dwSize;
HWND hwndParent;
DWORD dwFlags;
LPCSTR szTitle;
PCCERT_CONTEXT pCertContext;
LPCSTR *rgszPurposes;
DWORD cPurposes;
union {
CRYPT_PROVIDER_DATA const *pCryptProviderData;
HANDLE hWVTStateData;
};
BOOL fpCryptProviderDataTrustedUsage;
DWORD idxSigner;
DWORD idxCert;
BOOL fCounterSigner;
DWORD idxCounterSigner;
DWORD cStores;
HCERTSTORE *rghStores;
DWORD cPropSheetPages;
LPCPROPSHEETPAGEA rgPropSheetPages;
DWORD nStartPage;
} CRYPTUI_VIEWCERTIFICATE_STRUCTA, *PCRYPTUI_VIEWCERTIFICATE_STRUCTA;
Membros
dwSize
O tamanho, em bytes, da estrutura CRYPTUI_VIEWCERTIFICATE_STRUCT .
hwndParent
Um identificador para a janela que é o pai da caixa de diálogo produzida por CryptUIDlgViewCertificate.
dwFlags
Esse membro pode ser um ou mais dos valores a seguir.
| Valor | Significado |
|---|---|
|
A página Caminho de Certificação está desabilitada. |
|
A página Detalhes está desabilitada. |
|
O usuário não tem permissão para alterar as propriedades. |
|
O usuário tem permissão para alterar as propriedades. |
|
O botão Instalar está desabilitado. |
|
O botão Instalar está habilitado. |
|
As páginas ou botões que permitem ao usuário aceitar ou recusar qualquer decisão estão desabilitados. |
|
Um erro raiz não confiável é ignorado. |
|
Os repositórios confiáveis conhecidos não serão usados para criar a cadeia. |
|
Um repositório raiz confiável conhecido não será usado para criar a cadeia. |
|
Use somente ao exibir certificados em computadores remotos. Se esse sinalizador for usado, o primeiro elemento de rghStores deverá ser o identificador do repositório raiz no computador remoto. |
|
Habilite a verificação de revogação com o comportamento padrão. O comportamento padrão é habilitar a verificação de revogação de toda a cadeia de certificados, exceto o certificado raiz. Válido somente se nem o membro da união pCryptProviderData nem o membro da união hWVTStateData forem passados. |
|
Ao criar uma cadeia de certificados para um computador remoto, avise que a cadeia pode não ser confiável no computador remoto. |
|
Se esse sinalizador estiver definido, o botão Copiar para arquivo será desabilitado na página Detalhes . |
|
Habilite a verificação de revogação somente no certificado folha na cadeia de certificados. Válido somente se nem o membro da união pCryptProviderData nem o membro da união hWVTStateData forem passados. |
|
Habilite a verificação de revogação em cada certificado na cadeia de certificados. Válido somente se nem o membro da união pCryptProviderData nem o membro da união hWVTStateData forem passados.
Nota Como os certificados raiz raramente contêm informações que permitem a verificação de revogação, espera-se que o uso dessa opção geralmente resulte em falha da função CryptUIDlgViewCertificate . A opção recomendada é usar CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT. |
|
Habilite a verificação de revogação em cada certificado na cadeia de certificados, exceto para o certificado raiz. Essa é a opção recomendada a ser usada para verificação de revogação de certificado. Válido somente se nem o membro da união pCryptProviderData nem o membro da união hWVTStateData forem passados.
Nota Esse sinalizador é equivalente a CRYPTUI_ENABLE_REVOCATION_CHECKING. |
|
Desabilite o botão Ajuda HTML (?) na caixa de diálogo Certificado . |
|
Desabilite o botão Instrução emissor na guia Geral da caixa de diálogo Certificado . |
|
Desabilite a verificação de revogação online. Defina esse sinalizador para garantir que a função CryptUIDlgViewCertificate use o cache local para recuperar o certificado e não tente recuperar o certificado da rede.
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse sinalizador. |
szTitle
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o título da janela.
pCertContext
Um ponteiro para a estrutura CERT_CONTEXT que contém o contexto de certificado a ser exibido.
rgszPurposes
Uma matriz de ponteiros para cadeias de caracteres terminadas em nulo que contêm as finalidades para as quais esse certificado será validado.
cPurposes
O número de finalidades na matriz rgszPurposes .
pCryptProviderData
Se a função WinVerifyTrust já tiver sido chamada para o certificado e a função WTHelperProvDataFromStateData também tiver sido chamada, passe um ponteiro para a estrutura de estado que foi adquirida da chamada para WTHelperProvDataFromStateData. Se pCryptProviderData estiver definido, fpCryptProviderDataTrustedUsage, idxSigner, idxCert e fCounterSignature também deverão ser definidos.
hWVTStateData
Se WinVerifyTrust já tiver sido chamado para o certificado e WTHelperProvDataFromStateData não tiver sido chamado, passe o membro hWVTStateData da estrutura WINTRUST_DATA . Se hWVTStateData estiver definido, fpCryptProviderDataTrustedUsage, idxSigner, idxCert e fCounterSignature também deverão ser definidos.
fpCryptProviderDataTrustedUsage
Se WinVerifyTrust foi chamado, esse é o resultado de se o certificado era confiável.
idxSigner
O índice do signatário a ser exibido.
idxCert
O índice do certificado que está sendo exibido dentro da cadeia de signatários. O contexto de certificado desse certificado deve corresponder a pCertContext.
fCounterSigner
TRUE se uma contra-atribuição estiver sendo exibida. Se for TRUE, idxCounterSigner deverá ser válido.
idxCounterSigner
O índice do contra-atribuídor a ser exibido.
cStores
O número de outros repositórios na matriz rghStores de repositórios de certificados a serem pesquisados ao compilar e validar a cadeia de certificados.
rghStores
Uma matriz de HCERTSTORE manipula outros repositórios de certificados para pesquisar ao compilar e validar a cadeia de certificados.
cPropSheetPages
O número de páginas de propriedades a serem adicionadas à caixa de diálogo.
rgPropSheetPages
Uma matriz de páginas de propriedades a serem adicionadas à caixa de diálogo. Cada página nessa matriz não receberá o lParam na estrutura PROPSHEETPAGE como o lParam na mensagem WM_INITDIALOG . Em vez disso, ele receberá um ponteiro para uma estrutura CRYPTUI_INITDIALOG_STRUCT . Ele contém o lParam em PROPSHEETPAGE e o ponteiro para o CERT_CONTEXT para o qual a página está sendo exibida.
nStartPage
O índice da página inicial que será exibida. Se o bit mais alto (0x8000) for definido, o índice será considerado para indexar rgPropSheetPages (depois que o bit mais alto tiver sido removido, por exemplo, 0x8000 indicará a primeira página em rgPropSheetPages). Se o bit mais alto for zero, nStartPage será o índice inicial das páginas de propriedades da caixa de diálogo de certificado padrão.
Comentários
Observação
O cabeçalho cryptuiapi.h define CRYPTUI_VIEWCERTIFICATE_STRUCT como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
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 | cryptuiapi.h |