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.
| Eigenschaftenname | BESCHREIBUNG |
|---|---|
| printName | Enthält den ursprünglichen Druckernamen. |
| printLocation | Enthält den anfänglichen Druckerspeicherort. |
| printModel | Enthält den ursprünglichen Modellnamen und/oder die Nummer des Druckers. |
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:
| Wert | Rolle |
|---|---|
| 0x0000 | Alle Rollen |
| 0x0001 | Arbeitsstation oder Server |
| 0x0002 | Alle Domänencontroller |
| 0x0004 | Beschreibbare Domänencontroller |
| 0x0008 | Read-only-Domänencontroller |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Kopfzeile | cmnquery.h |