Estructura OPENQUERYWINDOW (cmnquery.h)

La estructura OPENQUERYWINDOW se usa con el método ICommonQuery::OpenQueryWindow para inicializar el cuadro de diálogo de consulta del servicio de directorio.

Sintaxis

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

Miembros

cbStruct

Contiene el tamaño, en bytes, de la estructura. Este miembro se usa para el control de versiones y la validación de parámetros y debe rellenarse antes de llamar a ICommonQuery::OpenQueryWindow.

dwFlags

Contiene un conjunto de marcas que definen el comportamiento del cuadro de diálogo de consulta del servicio de directorio. Puede ser cero o una combinación de uno o varios de los valores enumerados en la lista siguiente.

OQWF_DEFAULTFORM

Hace que el cuadro de diálogo de consulta seleccione el formulario especificado por el miembro clsidDefaultForm en la inicialización.

OQWF_HIDEMENUS

Hace que el cuadro de diálogo oculte la barra de menús.

OQWF_HIDESEARCHUI

Hace que el cuadro de diálogo de consulta se cree sin la interfaz de usuario de búsqueda estándar. Esto incluye los botones de inserción Buscar ahora, Detener y Borrar todo .

OQWF_ISSUEONOPEN

Hace que la consulta se ejecute cuando se muestre por primera vez el cuadro de diálogo de consulta.

OQWF_LOADQUERY

Hace que el cuadro de diálogo de consulta recupere la consulta de la interfaz IPersistQuery en el miembro pPersistQuery .

OQWF_OKCANCEL

Hace que el cuadro de diálogo de consulta muestre los botones Aceptar y Cancelar , si procede. Los botones que se muestran realmente en el cuadro de diálogo dependerán del formulario usado y de otras marcas especificadas.

OQWF_PARAMISPROPERTYBAG

Indica que el miembro ppbFormParameters contiene una interfaz IPropertyBag .

OQWF_REMOVEFORMS

Hace que el cuadro de diálogo de consulta se cree sin la etiqueta del selector de formularios y la lista desplegable representadas por la etiqueta Buscar: .

OQWF_REMOVESCOPES

Hace que el cuadro de diálogo de consulta se cree sin la etiqueta de ámbito y la lista desplegable representadas por la etiqueta In: .

OQWF_SAVEQUERYONOK

Hace que el cuadro de diálogo de consulta, cuando se cierre, guarde la consulta en la interfaz IPersistQuery en el miembro pPersistQuery .

OQWF_SHOWOPTIONAL

Hace que el cuadro de diálogo de consulta muestre formularios opcionales en la lista desplegable formulario. Los formularios opcionales son formularios que especifican la marca CQFF_ISOPTIONAL en el miembro dwFlags de la estructura CQFORM .

OQWF_SINGLESELECT

Hace que el cuadro de diálogo de consulta realice la selección única de la lista de resultados de la consulta.

clsidHandler

Contiene un valor CLSID que especifica el controlador de consultas que va a usar el cuadro de diálogo de consulta. El valor de este miembro también determina el tipo de estructura a la que apunta el miembro pHandlerParameters .

CLSID_DsQuery

Esta es la consulta de servicio de directorio estándar y la única consulta admitida actualmente.

pHandlerParameters

Puntero a una estructura que contiene datos para el controlador de consultas. El tipo de estructura a la que apunta este miembro se define mediante el miembro clsidHandler . En la lista siguiente se enumeran los posibles tipos de estructuras en función del valor del miembro clsidHandler .

CLSID_DsQuery

Contiene un puntero a una estructura DSQUERYINITPARAMS .

clsidDefaultForm

Especifica el formulario predeterminado que se va a mostrar en el cuadro de diálogo de consulta. Este miembro se omite si dwFlags no contiene OQWF_DEFAULTFORM. Este miembro puede contener el CLSID de un formulario de consulta personalizado o uno de los formularios proporcionados por el sistema.

CLSID_DsFindAdvanced

Identifica el formulario de consulta de Custom Search .

CLSID_DsFindComputer

Identifica el formulario de consulta Equipos .

CLSID_DsFindContainer

Identifica el formulario de consulta Unidades organizativas .

CLSID_DsFindDomainController

Identifica el formulario de consulta Controladores de dominio .

CLSID_DsFindFrsMembers

Identifica el formulario de consulta de miembros de FRS .

CLSID_DsFindObjects

Reservado.

CLSID_DsFindPeople

Identifica el formulario de consulta Usuarios, Contactos y Grupos .

CLSID_DsFindPrinter

Identifica el formulario de consulta Impresoras .

CLSID_DsFindVolume

Identifica el formulario de consulta Carpetas compartidas .

CLSID_DsFindWriteableDomainController

Identifica el formulario de consulta Controladores de dominio y muestra controladores de dominio grabables.

pPersistQuery

Puntero a una interfaz IPersistQuery usada para almacenar y recuperar datos de consulta. Estos datos pertenecen a la propia consulta, no a los resultados de la consulta. Si dwFlags contiene OQWF_LOADQUERY, los datos de consulta se obtienen de esta interfaz. Si dwFlags contiene OQWF_SAVEQUERY, los datos de consulta se guardan en esta interfaz.

pFormParameters

Reservado. Puntero a una estructura o interfaz que proporciona datos de inicialización de parámetros para el formulario. El contenido de este puntero se define mediante la clase de formulario especificada por el miembro clsidDefaultForm .

ppbFormParameters

Puntero a una interfaz IPropertyBag que proporciona datos de inicialización de parámetros para el formulario. El contenido de este contenedor de propiedades se define mediante la clase de formulario especificada por el miembro clsidDefaultForm . Los siguientes formularios proporcionados por el sistema admiten este miembro.

CLSID_DsFindPrinter

Este formulario obtiene las siguientes propiedades del contenedor de propiedades.

Nombre de propiedad	Descripción
printName	Contiene el nombre inicial de la impresora.
printLocation	Contiene la ubicación inicial de la impresora.
printModel	Contiene el nombre inicial del modelo o el número de la impresora.

 

CLSID_DsFindComputer

Use este formulario para especificar los roles de equipo. El contenedor de propiedades debe incluir computerRole. Use una combinación de los siguientes valores para restringir los roles que se incluyen:

Valor	Role
0x0000	Todos los roles
0x0001	Estación de trabajo o servidor
0x0002	Todos los controladores de dominio
0x0004	Controladores de dominio grabables
0x0008	Controladores de dominio de solo lectura

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Encabezado	cmnquery.h

Consulte también

CQFORM

DSQUERYINITPARAMS

Mostrar estructuras en Servicios de dominio de Active Directory

ICommonQuery::OpenQueryWindow

IPersistQuery