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)

Siehe auch

CryptUIDlgSelectCertificate