OPENQUERYWINDOW-Struktur (cmnquery.h)

Die OPENQUERYWINDOW-Struktur wird mit der ICommonQuery::OpenQueryWindow-Methode verwendet, um das Dialogfeld Verzeichnisdienstabfrage zu initialisieren.

Syntax

typedef struct {
  DWORD         cbStruct;
  DWORD         dwFlags;
  CLSID         clsidHandler;
  LPVOID        pHandlerParameters;
  CLSID         clsidDefaultForm;
  IPersistQuery *pPersistQuery;
  union {
    void         *pFormParameters;
    IPropertyBag *ppbFormParameters;
  };
} OPENQUERYWINDOW, *LPOPENQUERYWINDOW;

Member

cbStruct

Enthält die Größe der Struktur in Bytes. Dieses Element wird für die Versionsverwaltung und Parameterüberprüfung verwendet und muss vor dem Aufrufen von ICommonQuery::OpenQueryWindow ausgefüllt werden.

dwFlags

Enthält eine Reihe von Flags, die das Verhalten des Dialogfelds Verzeichnisdienstabfrage definieren. Dies kann null oder eine Kombination aus einem oder mehreren der in der folgenden Liste aufgeführten Werte sein.

OQWF_DEFAULTFORM

Bewirkt, dass das Abfragedialogfeld das Formular auswählt, das durch das Element clsidDefaultForm bei der Initialisierung angegeben wurde.

OQWF_HIDEMENUS

Bewirkt, dass das Dialogfeld die Menüleiste ausblendet.

OQWF_HIDESEARCHUI

Bewirkt, dass das Abfragedialogfeld ohne die Standard-Such-Benutzeroberfläche erstellt wird. Dies umfasst die Drucktasten "Jetzt suchen", "Beenden" und " Alle löschen ".

OQWF_ISSUEONOPEN

Bewirkt, dass die Abfrage ausgeführt wird, wenn das Abfragedialogfeld zum ersten Mal angezeigt wird.

OQWF_LOADQUERY

Bewirkt, dass das Abfragedialogfeld die Abfrage von der IPersistQuery-Schnittstelle im pPersistQuery-Element abruft .

OQWF_OKCANCEL

Bewirkt, dass im Abfragedialogfeld die Schaltflächen OK und Abbrechen angezeigt werden, falls zutreffend. Welche Schaltflächen tatsächlich im Dialogfeld angezeigt werden, hängt vom verwendeten Formular und anderen angegebenen Flags ab.

OQWF_PARAMISPROPERTYBAG

Gibt an, dass das ppbFormParameters-Element eine IPropertyBag-Schnittstelle enthält.

OQWF_REMOVEFORMS

Bewirkt, dass das Abfragedialogfeld ohne die Formularwählungsbezeichnung und Die Dropdownliste erstellt wird, die durch die Bezeichnung Suchen: dargestellt wird.

OQWF_REMOVESCOPES

Bewirkt, dass das Abfragedialogfeld ohne die Bereichsbezeichnung und Die Dropdownliste erstellt wird, die durch die Bezeichnung In: dargestellt wird.

OQWF_SAVEQUERYONOK

Bewirkt, dass das Abfragedialogfeld, wenn es geschlossen wird, die Abfrage in der IPersistQuery-Schnittstelle im pPersistQuery-Element speichert.

OQWF_SHOWOPTIONAL

Bewirkt, dass das Abfragedialogfeld optionale Formulare in der Dropdownliste Formular anzeigt. Optionale Formulare sind Formulare, die das CQFF_ISOPTIONAL-Flag im dwFlags-Element der CQFORM-Struktur angeben.

OQWF_SINGLESELECT

Bewirkt, dass das Abfragedialogfeld die Liste der Abfrageergebnisse als Einzelauswahl angibt.

clsidHandler

Enthält einen CLSID-Wert , der den Abfragehandler angibt, der vom Abfragedialogfeld verwendet werden soll. Der Wert dieses Members bestimmt auch den Typ der Struktur, auf die das pHandlerParameters-Element verweist.

CLSID_DsQuery

Dies ist die Standardverzeichnisdienstabfrage und die einzige derzeit unterstützte Abfrage.

pHandlerParameters

Zeiger auf eine Struktur, die Daten für den Abfragehandler enthält. Der Strukturtyp, auf den dieses Element verweist, wird durch das clsidHandler-Element definiert. Die folgende Liste listet die möglichen Typen von Strukturen auf, die auf dem Wert des clsidHandler-Elements basieren.

CLSID_DsQuery

Enthält einen Zeiger auf eine DSQUERYINITPARAMS-Struktur .

clsidDefaultForm

Gibt das Standardformular an, das im Abfragedialogfeld angezeigt werden soll. Dieser Member wird ignoriert, wenn dwFlags keine OQWF_DEFAULTFORM enthält. Dieses Element kann die CLSID eines benutzerdefinierten Abfrageformulars oder eines der vom System bereitgestellten Formulare enthalten.

CLSID_DsFindAdvanced

Gibt das Abfrageformular für die benutzerdefinierte Suche an.

CLSID_DsFindComputer

Gibt das Abfrageformular Computer an.

CLSID_DsFindContainer

Identifiziert das Abfrageformular Organisationseinheiten .

CLSID_DsFindDomainController

Gibt das Abfrageformular für Domänencontroller an.

CLSID_DsFindFrsMembers

Identifiziert das FrS-Member-Abfrageformular .

CLSID_DsFindObjects

Reserviert.

CLSID_DsFindPeople

Identifiziert das Abfrageformular "Benutzer", "Kontakte" und "Gruppen ".

CLSID_DsFindPrinter

Gibt das Abfrageformular Drucker an.

CLSID_DsFindVolume

Identifiziert das Abfrageformular für freigegebene Ordner .

CLSID_DsFindWriteableDomainController

Identifiziert das Abfrageformular für Domänencontroller und zeigt beschreibbare Domänencontroller an.

pPersistQuery

Zeiger auf eine IPersistQuery-Schnittstelle , die zum Speichern und Abrufen von Abfragedaten verwendet wird. Diese Daten beziehen sich auf die Abfrage selbst, nicht auf die Ergebnisse der Abfrage. Wenn dwFlagsOQWF_LOADQUERY enthält, werden die Abfragedaten von dieser Schnittstelle abgerufen. Wenn dwFlagsOQWF_SAVEQUERY enthält, werden die Abfragedaten in dieser Schnittstelle gespeichert.

pFormParameters

Reserviert. Zeiger auf eine Struktur oder Schnittstelle, die Parameterinitialisierungsdaten für das Formular bereitstellt. Der Inhalt dieses Zeigers wird durch die Formularklasse definiert, die durch das clsidDefaultForm-Element angegeben wird.

ppbFormParameters

Zeiger auf eine IPropertyBag-Schnittstelle , die Parameterinitialisierungsdaten für das Formular bereitstellt. Der Inhalt dieses Eigenschaftenbehälters wird durch die Formularklasse definiert, die durch das clsidDefaultForm-Element angegeben wird. Dieses Element wird von den folgenden systemseitig bereitgestellten Formularen unterstützt.

CLSID_DsFindPrinter

Dieses Formular ruft die folgenden Eigenschaften aus dem Eigenschaftenbehälter ab.

CLSID_DsFindComputer

Verwenden Sie dieses Formular, um die Computerrollen anzugeben. Der Eigenschaftenbehälter muss computerRole enthalten. Verwenden Sie eine Kombination der folgenden Werte, um einzuschränken, welche Rollen enthalten sind:

Anforderungen

Weitere Informationen

CQFORM

DSQUERYINITPARAMS

Anzeigen von Strukturen in Active Directory Domain Services

ICommonQuery::OpenQueryWindow

IPersistQuery