CRYPTUI_SELECTCERTIFICATE_STRUCT Struktur

Artikel
06/12/2023

Die CRYPTUI_SELECTCERTIFICATE_STRUCT-Struktur enthält Informationen zum Dialogfeld, das von der Funktion CryptUIDlgSelectCertificate 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 Funktion CryptUIDlgSelectCertificate an . Dies kann null oder ein bitweiser 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, mehrere Zertifikate im Dialogfeld auszuwählen. Wenn dieses Flag festgelegt ist, gibt die CryptUIDlgSelectCertificate-Funktion immer NULL zurück. Das hSelectedCertStore-Mitglied 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 Kryptografie-Benutzeroberfläche das obere Fenster auf dem Bildschirm ist.

szTitle

Der Anzeigetitel für das Dialogfeld. Wenn der Wert dieses Members 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)	Zeigen Sie keine ISSUEDTO-Informationen an.
CRYPTUI_SELECT_ISSUEDBY_COLUMN 2 (0x2)	Zeigen Sie keine ISSUEDBY-Informationen an.
CRYPTUI_SELECT_INTENDEDUSE_COLUMN 4 (0x4)	Zeigen Sie keine Informationen zur beabsichtigten Verwendung an .
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN 8 (0x8)	Zeigen Sie keine Namensinformationen an.
CRYPTUI_SELECT_LOCATION_COLUMN 16 (0x10)	Zeigen Sie keine Standortinformationen an.
CRYPTUI_SELECT_EXPIRATION_COLUMN 32 (0x20)	Zeigen Sie keine Ablaufinformationen an.

szDisplayString

Text, der im Dialogfeld angezeigt wird, um den Benutzer anzuweisen. Wenn der Wert dieses Members NULL ist, wird die Standardzeichenfolge "Wählen Sie ein Zertifikat aus, 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 zum Anzeigen 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 rghDisplayStores-Array .

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 der Überprüfung der Vertrauensstellung für die im Dialogfeld angezeigten Zertifikate gesucht werden sollen.

cPropSheetPages

Die Anzahl der Eigenschaftenseiten im Array rgPropSheetPages .

rgPropSheetPages

Ein Zeiger auf ein Array von PROPSHEETPAGE-Strukturen , die Eigenschaftenseiten darstellen, die an das Dialogfeld Zertifikatanzeige übergeben werden, wenn ein Zertifikat für die Anzeige ausgewählt wird.

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 CryptUIDlgSelectCertificate gleich ist, hat der Benutzer das Dialogfeld geschlossen, ohne Zertifikate auszuwählen.

Dieses Element wird nicht verwendet, wenn das dwFlags-Element dieser Struktur nicht das CRYPTUI_SELECTCERT_MULTISELECT-Flag enthält.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Unicode- und ANSI-Name	CRYPTUI_SELECTCERTIFICATE_STRUCTW (Unicode) und CRYPTUI_SELECTCERTIFICATE_STRUCTA (ANSI)

Siehe auch

CryptUIDlgSelectCertificate

Share via