CRYPTUI _ _ SELECTCERTIFICATE-STRUKTUR
Die CRYPTUI _ SELECTCERTIFICATE-Struktur _ enthält Informationen zum Dialogfeld, das von der CryptUIDlgSelectCertificate-Funktion angezeigt wird.
Syntax
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;
Member
-
dwSize
-
Die Größe (in Bytes) dieser Struktur.
-
hwndParent
-
Das Handle des übergeordneten Fensters des Dialogfelds. Wenn dieser Wert NULL ist, ist das übergeordnete Fenster das Standarddesktopfenster.
-
dwFlags
-
Gibt zusätzliche Optionen für die CryptUIDlgSelectCertificate-Funktion an. Dies kann 0 (null) oder ein bitweises OR der folgenden Werte sein.
Wert Bedeutung - CRYPTUI _ SELECTCERT _ ADDFROMDS
Reserviert. - CRYPTUI _ SELECTCERT _ LEGACY
Gibt an, dass das Legacydialogfeld angezeigt werden soll. - CRYPTUI _ SELECTCERT _ MULTISELECT
Ermöglicht dem Benutzer die Auswahl von mehr als einem Zertifikat im Dialogfeld. Wenn dieses Flag festgelegt ist, gibt die CryptUIDlgSelectCertificate-Funktion immer NULL zurück. Das hSelectedCertStore-Member dieser Struktur muss ein Handle für einen Zertifikatspeicher enthalten. Die vom Benutzer ausgewählten Zertifikate werden diesem Speicher hinzugefügt. - CRYPTUI _ SELECTCERT _ PUT _ WINDOW _ TOPMOST
Erzwingt, dass die Kryptografiebenutzeroberfläche das oberste Fenster auf dem Bildschirm ist. -
szTitle
-
Der Anzeigetitel für das Dialogfeld. Wenn der Wert dieses Mitglieds NULL ist, wird der Standardtitel "Zertifikat auswählen" verwendet.
-
dwDontUseColumn
-
Flags, die kombiniert werden können, um Spalten der Anzeige auszuschließen.
Wert Bedeutung - CRYPTUI _ SELECT _ ISSUEDTO _ COLUMN
- 1 (0X1)
Zeigt keine ISSUEDTO-Informationen an. - CRYPTUI _ SELECT _ ISSUEDBY _ COLUMN
- 2 (0X2)
Zeigt keine ISSUEDBY-Informationen an. - CRYPTUI _ WÄHLEN _ SIE INTENDEDUSE _ COLUMN
- 4 (0X4) AUS.
Zeigt keine IntendedUse-Informationen an. - CRYPTUI _ WÄHLEN _ SIE FRIENDLYNAME _ COLUMN
- 8 (0X8) AUS.
Zeigen Sie keine Namensinformationen an. - CRYPTUI _ SELECT _ LOCATION _ COLUMN
- 16 (0X10)
Zeigen Sie keine Standortinformationen an. - CRYPTUI _ AUSWÄHLEN _ VON _ ABLAUFSPALTE
- 32 (0X20)
Zeigen Sie keine Ablaufinformationen an. -
szDisplayString
-
Text, der im Dialogfeld angezeigt wird, um den Benutzer anweisen zu können. Wenn der Wert dieses Members NULL ist, wird die Standardzeichenfolge "Select a certificate you want to use" (Zertifikat auswählen, das Sie verwenden möchten) verwendet.
-
pFilterCallback
-
Ein Zeiger auf eine PFNCFILTERPROC-Rückruffunktion, die die im Dialogfeld angezeigten Zertifikate filtert.
-
pDisplayCallback
-
Ein Zeiger auf eine PFNCCERTDISPLAYPROC-Rückruffunktion, die Zertifikate anzeigt, die der Benutzer zur Anzeige auswählt.
-
pvCallbackData
-
Zusätzliche Daten, die an die Rückruffunktionen übergeben werden, die von den pFilterCallback- und pDisplayCallback-Membern angegeben werden.
-
cDisplayStores
-
Die Anzahl der Zertifikatspeicher im Array rghDisplayStores.
-
rghDisplayStores
-
Ein Zeiger auf ein Array von Speichern, die Zertifikate enthalten, die im Dialogfeld zur Auswahl verfügbar sind.
-
cStores
-
Die Anzahl der Zertifikatspeicher im rghStores-Array.
-
rghStores
-
Ein Zeiger auf ein Array von Zertifikatspeichern, die beim Erstellen einer Zertifikatkette und Überprüfen der Vertrauensstellung für die im Dialogfeld angezeigten Zertifikate durchsucht werden.
-
cPropSheetPages
-
Die Anzahl der Eigenschaftenseiten im rgPropSheetPages-Array.
-
rgPropSheetPages
-
Ein Zeiger auf ein Array von PROPSHEETPAGE-Strukturen, die Eigenschaftenseiten darstellen, die an das Dialogfeld zum Anzeigen des Zertifikats übergeben werden, wenn ein Zertifikat für die Anzeige ausgewählt ist.
-
hSelectedCertStore
-
Ein Handle für einen vom Aufrufer erstellten Zertifikatspeicher. Die vom Benutzer ausgewählten Zertifikate werden diesem Speicher hinzugefügt. Wenn die Anzahl der Zertifikate in diesem Speicher vor und nach dem Aufruf von CryptUIDlgSelectCertificategleich ist, hat der Benutzer das Dialogfeld geschlossen, ohne Zertifikate auszuwählen.
Dieser Member wird nicht verwendet, wenn das dwFlags-Member dieser Struktur nicht das CRYPTUI _ SELECTCERT _ MULTISELECT-Flag enthält.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Unicode- und ANSI-Name |
CRYPTUI _ SELECTCERTIFICATE _ STRUCTW (Unicode) und CRYPTUI _ SELECTCERTIFICATE _ STRUCTA (ANSI) |