DSQUERYINITPARAMS-Struktur (dsquery.h)

Artikel
02/29/2024

Die DSQUERYINITPARAMS-Struktur beschreibt die Daten, die zum Initialisieren eines Suchdialogfelds in der Verzeichnisdienstabfrage verwendet werden.

Syntax

typedef struct {
  DWORD  cbStruct;
  DWORD  dwFlags;
  LPWSTR pDefaultScope;
  LPWSTR pDefaultSaveLocation;
  LPWSTR pUserName;
  LPWSTR pPassword;
  LPWSTR pServer;
} DSQUERYINITPARAMS, *LPDSQUERYINITPARAMS;

Member

cbStruct

Enthält die Größe dieser Struktur in Bytes.

dwFlags

Enthält eine Reihe von Flags, die das Abfrageverhalten definieren. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.

DSQPF_ENABLEADMINFEATURES

Verwendet funktionen, die von den Verwaltungstools des Verzeichnisdiensts unterstützt werden, z. B. Admin Display Specifier für Kontextmenüs und Eigenschaftenseiten.

DSQPF_ENABLEADVANCEDFEATURES

Gibt erweiterte Features im IDataObject-instance an Kontextmenüs und Eigenschaftenseiten übergeben werden.

DSQPF_HASCREDENTIALS

Die pUserName-, pPassword - und pServer-Member dieser Struktur können Server- und Anmeldeinformationen angeben.

DSQPF_NOCHOOSECOLUMNS

Deaktiviert das Element Spalten auswählen im Abfragedialogfeld Ansicht .

DSQPF_NOSAVE

Entfernt das Element Suche speichern aus dem Abfragedialogfeld Dateimenü .

DSQPF_SAVELOCATION

Das pDefaultSaveLocation-Element enthält den Standarddateisystempfad, in dem Suchvorgänge gespeichert werden.

DSQPF_SHOWHIDDENOBJECTS

Bewirkt, dass das Abfragedialogfeld ausgeblendete Objekte in der Abfrageergebnisliste anzeigt.

pDefaultScope

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den ADsPath des Standardbereichs für die Suche enthält. Legen Sie dieses Element auf NULL fest, wenn kein Standardsuchbereich angegeben ist.

pDefaultSaveLocation

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Standarddateisystempfad enthält, in dem Suchvorgänge gespeichert werden. Dieser Member wird ignoriert, wenn der dwFlags-Member keine DSQPF_SAVELOCATION enthält.

pUserName

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Benutzernamen in der gültigen Domänennotation enthält, z. B. "fabrikam\jeffsmith".

pPassword

Zeiger auf eine mit Null beendete Unicode-Zeichenfolge, die das Kennwort des Benutzers enthält, der vom pUserName-Member angegeben wurde.

pServer

Zeiger auf eine mit NULL beendete Unicode-Zeichenfolge, die den Namen des Servers enthält, von dem die Liste der vertrauenswürdigen Domänen gelesen wird. Die Liste wird verwendet, um die Dropdownliste In: im Dialogfeld aufzufüllen.

Hinweise

Diese Struktur ist spezifisch für den CLSID_DsQuery Abfragehandler. Diese Struktur wird für das pHandlerParameters-Element der OPENQUERYWINDOW-Struktur verwendet, wenn CLSID_DsQuery für das clsidHandler-Element der OPENQUERYWINDOW-Struktur festgelegt ist. Weitere Informationen und ein Codebeispiel für die Verwendung dieser und anderer verwandter APIs finden Sie unter ICommonQuery::OpenQueryWindow.