estrutura CRYPTUI_SELECTCERTIFICATE_STRUCT

A estrutura CRYPTUI_SELECTCERTIFICATE_STRUCT contém informações sobre a caixa de diálogo exibida pela função CryptUIDlgSelectCertificate .

Sintaxe

typedef struct _CRYPTUI_SELECTCERTIFICATE_STRUCT {
  DWORD               dwSize;
  HWND                hwndParent;
  DWORD               dwFlags;
  LPCTSTR             szTitle;
  DWORD               dwDontUseColumn;
  LPCTSTR             szDisplayString;
  PFNCFILTERPROC      pFilterCallback;
  PFNCCERTDISPLAYPROC pDisplayCallback;
  void                *pvCallbackData;
  DWORD               cDisplayStores;
  HCERTSTORE          *rghDisplayStores;
  DWORD               cStores;
  HCERTSTORE          *rghStores;
  DWORD               cPropSheetPages;
  LPCPROPSHEETPAGE    rgPropSheetPages;
  HCERTSTORE          hSelectedCertStore;
} CRYPTUI_SELECTCERTIFICATE_STRUCT, *PCRYPTUI_SELECTCERTIFICATE_STRUCT;

Membros

Dwsize

O tamanho, em bytes, dessa estrutura.

Hwndparent

O identificador da janela pai da caixa de diálogo. Se esse valor for NULL, a janela pai será a janela da área de trabalho padrão.

dwFlags

Especifica opções adicionais para a função CryptUIDlgSelectCertificate . Isso pode ser zero ou um OR bit a bit dos valores a seguir.

Valor Significado
CRYPTUI_SELECTCERT_ADDFROMDS
Reservado.
CRYPTUI_SELECTCERT_LEGACY
Especifica que a caixa de diálogo herdada deve ser exibida.
CRYPTUI_SELECTCERT_MULTISELECT
Permite que o usuário selecione mais de um certificado na caixa de diálogo. Se esse sinalizador for definido, a função CryptUIDlgSelectCertificate sempre retornará NULL. O membro hSelectedCertStore dessa estrutura deve conter um identificador para um repositório de certificados. Os certificados selecionados pelo usuário serão adicionados a este repositório.
CRYPTUI_SELECTCERT_PUT_WINDOW_TOPMOST
Força a interface do usuário de criptografia a ser a janela superior na tela.

 

szTitle

O título de exibição da caixa de diálogo. Se o valor desse membro for NULL, o título padrão de "Selecionar Certificado" será usado.

dwDontUseColumn

Sinalizadores que podem ser combinados para excluir colunas da exibição.

Valor Significado
CRYPTUI_SELECT_ISSUEDTO_COLUMN
1 (0x1)
Não exiba informações ISSUEDTO .
CRYPTUI_SELECT_ISSUEDBY_COLUMN
2 (0x2)
Não exiba informações ISSUEDBY .
CRYPTUI_SELECT_INTENDEDUSE_COLUMN
4 (0x4)
Não exiba informações de IntendedUse .
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN
8 (0x8)
Não exibir informações de nome.
CRYPTUI_SELECT_LOCATION_COLUMN
16 (0x10)
Não exiba informações de localização.
CRYPTUI_SELECT_EXPIRATION_COLUMN
32 (0x20)
Não exiba informações de expiração.

 

szDisplayString

Texto exibido na caixa de diálogo para instruir o usuário. Se o valor desse membro for NULL, a cadeia de caracteres padrão "Selecionar um certificado que você deseja usar" será usada.

pFilterCallback

Um ponteiro para uma função de retorno de chamada PFNCFILTERPROC que filtra os certificados exibidos na caixa de diálogo.

pDisplayCallback

Um ponteiro para uma função de retorno de chamada PFNCCERTDISPLAYPROC que exibe certificados que o usuário seleciona para exibir.

pvCallbackData

Dados adicionais que são passados para as funções de retorno de chamada especificadas pelos membros pFilterCallback e pDisplayCallback .

cDisplayStores

O número de repositórios de certificados na matriz rghDisplayStores .

rghDisplayStores

Um ponteiro para uma matriz de repositórios que contêm certificados disponíveis para seleção na caixa de diálogo.

cStores

O número de repositórios de certificados na matriz rghStores .

rghStores

Um ponteiro para uma matriz de repositórios de certificados para pesquisar ao criar uma cadeia de certificados e verificar a confiança dos certificados exibidos na caixa de diálogo.

cPropSheetPages

O número de páginas de propriedades na matriz rgPropSheetPages .

rgPropSheetPages

Um ponteiro para uma matriz de estruturas PROPSHEETPAGE que representam páginas de propriedade que são passadas para a caixa de diálogo de exibição de certificado quando um certificado é selecionado para exibição.

hSelectedCertStore

Um identificador para um repositório de certificados criado pelo chamador. Os certificados selecionados pelo usuário são adicionados a este repositório. Se o número de certificados nesse repositório for o mesmo antes e depois de chamar CryptUIDlgSelectCertificate, o usuário fechou a caixa de diálogo sem selecionar nenhum certificado.

Esse membro não será usado se o membro dwFlags dessa estrutura não contiver o sinalizador CRYPTUI_SELECTCERT_MULTISELECT .

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]
Nomes Unicode e ANSI
CRYPTUI_SELECTCERTIFICATE_STRUCTW (Unicode) e CRYPTUI_SELECTCERTIFICATE_STRUCTA (ANSI)

Confira também

CryptUIDlgSelectCertificate