STRUCTURE OPENQUERYWINDOW (cmnquery.h)

La structure OPENQUERYWINDOW est utilisée avec la méthode ICommonQuery ::OpenQueryWindow pour initialiser la boîte de dialogue de requête du service d’annuaire.

Syntaxe

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

Membres

cbStruct

Contient la taille, en octets, de la structure. Ce membre est utilisé pour le contrôle de version et la validation des paramètres et doit être renseigné avant d’appeler ICommonQuery ::OpenQueryWindow.

dwFlags

Contient un ensemble d’indicateurs qui définissent le comportement de la boîte de dialogue de requête de service d’annuaire. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs répertoriées dans la liste suivante.

OQWF_DEFAULTFORM

Provoque la boîte de dialogue de requête à sélectionner le formulaire spécifié par le membre clsidDefaultForm lors de l’initialisation.

OQWF_HIDEMENUS

Provoque la boîte de dialogue à masquer la barre de menus.

OQWF_HIDESEARCHUI

Provoque la création de la boîte de dialogue de requête sans l’interface utilisateur de recherche standard. Cela inclut les boutons pushbuttons Rechercher maintenant, Arrêter et Effacer tous les boutons.

OQWF_ISSUEONOPEN

Provoque l’exécution de la requête lorsque la boîte de dialogue de requête est affichée pour la première fois.

OQWF_LOADQUERY

Provoque la boîte de dialogue de requête pour récupérer la requête à partir de l’interface IPersistQuery dans le membre pPersistQuery .

OQWF_OKCANCEL

La boîte de dialogue de requête affiche les boutons OK et Annuler , le cas échéant. Les boutons réellement affichés dans la boîte de dialogue dépendent du formulaire utilisé et d’autres indicateurs spécifiés.

OQWF_PARAMISPROPERTYBAG

Indique que le membre ppbFormParameters contient une interface IPropertyBag .

OQWF_REMOVEFORMS

Provoque la création de la boîte de dialogue de requête sans l’étiquette du sélecteur de formulaire et la liste déroulante représentée par l’étiquette Rechercher : .

OQWF_REMOVESCOPES

Provoque la création de la boîte de dialogue de requête sans l’étiquette d’étendue et la liste déroulante représentées par l’étiquette In : .

OQWF_SAVEQUERYONOK

Entraîne l’enregistrement de la requête dans l’interface IPersistQuery dans le membre pPersistQuery .

OQWF_SHOWOPTIONAL

La boîte de dialogue de requête affiche les formulaires facultatifs dans la liste déroulante des formulaires. Les formulaires facultatifs sont des formulaires qui spécifient l’indicateur CQFF_ISOPTIONAL dans le membre dwFlags de la structure CQFORM .

OQWF_SINGLESELECT

Provoque la boîte de dialogue de requête pour que la liste des résultats de la requête ne fasse qu’une sélection unique.

clsidHandler

Contient une valeur CLSID qui spécifie le gestionnaire de requêtes à utiliser par la boîte de dialogue de requête. La valeur de ce membre détermine également le type de structure pointé vers le membre pHandlerParameters .

CLSID_DsQuery

Il s’agit de la requête de service d’annuaire standard et de la seule requête actuellement prise en charge.

pHandlerParameters

Pointeur vers une structure qui contient des données pour le gestionnaire de requêtes. Le type de structure pointé vers ce membre est défini par le membre clsidHandler . La liste suivante répertorie les types de structures possibles en fonction de la valeur du membre clsidHandler .

CLSID_DsQuery

Contient un pointeur vers une structure DSQUERYINITPARAMS .

clsidDefaultForm

Spécifie le formulaire par défaut à afficher dans la boîte de dialogue de requête. Ce membre est ignoré si dwFlags ne contient pas de OQWF_DEFAULTFORM. Ce membre peut contenir le CLSID d’un formulaire de requête personnalisé ou l’un des formulaires fournis par le système.

CLSID_DsFindAdvanced

Identifie le formulaire de requête Recherche personnalisée .

CLSID_DsFindComputer

Identifie le formulaire de requête Ordinateurs .

CLSID_DsFindContainer

Identifie le formulaire de requête Unités d’organisation .

CLSID_DsFindDomainController

Identifie le formulaire de requête Contrôleurs de domaine .

CLSID_DsFindFrsMembers

Identifie le formulaire de requête Membres FRS .

CLSID_DsFindObjects

Réservé.

CLSID_DsFindPeople

Identifie le formulaire de requête Utilisateurs, Contacts et Groupes .

CLSID_DsFindPrinter

Identifie le formulaire de requête Imprimantes .

CLSID_DsFindVolume

Identifie le formulaire de requête Dossiers partagés .

CLSID_DsFindWriteableDomainController

Identifie le formulaire de requête contrôleurs de domaine et affiche les contrôleurs de domaine accessibles en écriture.

pPersistQuery

Pointeur vers une interface IPersistQuery utilisée pour stocker et récupérer des données de requête. Ces données concernent la requête elle-même, et non les résultats de la requête. Si dwFlags contient OQWF_LOADQUERY, les données de requête sont obtenues à partir de cette interface. Si dwFlags contient OQWF_SAVEQUERY, les données de requête sont enregistrées dans cette interface.

pFormParameters

Réservé. Pointeur vers une structure ou une interface qui fournit des données d’initialisation de paramètre pour le formulaire. Le contenu de ce pointeur est défini par la classe de formulaire spécifiée par le membre clsidDefaultForm .

ppbFormParameters

Pointeur vers une interface IPropertyBag qui fournit des données d’initialisation de paramètre pour le formulaire. Le contenu de ce conteneur de propriétés est défini par la classe de formulaire spécifiée par le membre clsidDefaultForm . Les formulaires suivants fournis par le système prennent en charge ce membre.

CLSID_DsFindPrinter

Ce formulaire obtient les propriétés suivantes à partir du conteneur de propriétés.

Nom de la propriété	Description
printName	Contient le nom initial de l’imprimante.
printLocation	Contient l’emplacement initial de l’imprimante.
printModel	Contient le nom du modèle initial et/ou le numéro de l’imprimante.

 

CLSID_DsFindComputer

Utilisez ce formulaire pour spécifier les rôles d’ordinateur. Le conteneur de propriétés doit inclure computerRole. Utilisez une combinaison des valeurs suivantes pour limiter les rôles inclus :

Valeur	Rôle
0x0000	Tous les rôles
0x0001	Station de travail ou serveur
0x0002	Tous les contrôleurs de domaine
0x0004	Contrôleurs de domaine accessibles en écriture
0x0008	Contrôleurs de domaine en lecture seule

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	cmnquery.h

Voir aussi

CQFORM

DSQUERYINITPARAMS

Afficher les structures dans services de domaine Active Directory

ICommonQuery ::OpenQueryWindow

IPersistQuery