CRYPTUI_SELECTCERTIFICATE_STRUCT struttura

La struttura CRYPTUI_SELECTCERTIFICATE_STRUCT contiene informazioni sulla finestra di dialogo visualizzata dalla funzione CryptUIDlgSelectCertificate .

Sintassi

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;

Members

dwSize

Dimensione, in byte, della struttura.

hwndParent

Handle della finestra padre della finestra di dialogo. Se questo valore è NULL, la finestra padre è la finestra desktop predefinita.

dwFlags

Specifica opzioni aggiuntive per la funzione CryptUIDlgSelectCertificate . Questo può essere zero o un OR bit per bit dei valori seguenti.

Valore	Significato
CRYPTUI_SELECTCERT_ADDFROMDS	Riservato.
CRYPTUI_SELECTCERT_LEGACY	Specifica che la finestra di dialogo legacy deve essere visualizzata.
CRYPTUI_SELECTCERT_MULTISELECT	Consente all'utente di selezionare più certificati nella finestra di dialogo. Se questo flag è impostato, la funzione CryptUIDlgSelectCertificate restituisce sempre NULL. Il membro hSelectedCertStore di questa struttura deve contenere un handle in un archivio certificati. I certificati selezionati dall'utente verranno aggiunti all'archivio.
CRYPTUI_SELECTCERT_PUT_WINDOW_TOPMOST	Forza l'interfaccia utente di crittografia in modo che sia la finestra superiore sullo schermo.

 

szTitle

Titolo visualizzato per la finestra di dialogo. Se il valore di questo membro è NULL, viene usato il titolo predefinito "Seleziona certificato".

dwDontUseColumn

Flag che possono essere combinati per escludere colonne della visualizzazione.

Valore	Significato
CRYPTUI_SELECT_ISSUEDTO_COLUMN 1 (0x1)	Non visualizzare le informazioni ISSUEDTO .
CRYPTUI_SELECT_ISSUEDBY_COLUMN 2 (0x2)	Non visualizzare le informazioni ISSUEDBY .
CRYPTUI_SELECT_INTENDEDUSE_COLUMN 4 (0x4)	Non visualizzare le informazioni IntendedUse .
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN 8 (0x8)	Non visualizzare le informazioni sul nome.
CRYPTUI_SELECT_LOCATION_COLUMN 16 (0x10)	Non visualizzare le informazioni sulla posizione.
CRYPTUI_SELECT_EXPIRATION_COLUMN 32 (0x20)	Non visualizzare le informazioni sulla scadenza.

 

szDisplayString

Testo visualizzato nella finestra di dialogo per indicare all'utente. Se il valore di questo membro è NULL, viene usata la stringa predefinita "Selezionare un certificato da usare".

pFilterCallback

Puntatore a una funzione di callback PFNCFILTERPROC che filtra i certificati visualizzati nella finestra di dialogo.

pDisplayCallback

Puntatore a una funzione di callback PFNCCERTDISPLAYPROC che visualizza i certificati selezionati dall'utente per visualizzare.

pvCallbackData

Dati aggiuntivi passati alle funzioni di callback specificate dai membri pFilterCallback e pDisplayCallback.

cDisplayStores

Numero di archivi certificati nella matrice rghDisplayStores .

rghDisplayStores

Puntatore a una matrice di archivi che contengono certificati disponibili per la selezione nella finestra di dialogo.

cStores

Numero di archivi certificati nella matrice rghStores .

rghStores

Puntatore a una matrice di archivi certificati da cercare durante la compilazione di una catena di certificati e la verifica dell'attendibilità dei certificati visualizzati nella finestra di dialogo.

cPropSheetPages

Numero di pagine delle proprietà nella matrice rgPropSheetPages .

rgPropSheetPages

Puntatore a una matrice di strutture PROPSHEETPAGE che rappresentano le pagine delle proprietà passate alla finestra di dialogo visualizzazione del certificato quando viene selezionato un certificato per la visualizzazione.

hSelectedCertStore

Handle in un archivio certificati creato dal chiamante. I certificati selezionati dall'utente vengono aggiunti a questo archivio. Se il numero di certificati in questo archivio è lo stesso prima e dopo aver chiamato CryptUIDlgSelectCertificate, l'utente ha chiuso la finestra di dialogo senza selezionare alcun certificato.

Questo membro non viene usato se il membro dwFlags di questa struttura non contiene il flag di CRYPTUI_SELECTCERT_MULTISELECT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Nomi Unicode e ANSI	CRYPTUI_SELECTCERTIFICATE_STRUCTW (Unicode) e CRYPTUI_SELECTCERTIFICATE_STRUCTA (ANSI)

Vedi anche

CryptUIDlgSelectCertificate