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
Mostrar estructuras en Servicios de dominio de Active Directory