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.
typedef struct {
DWORD cbStruct;
DWORD dwFlags;
CLSID clsidHandler;
LPVOID pHandlerParameters;
CLSID clsidDefaultForm;
IPersistQuery *pPersistQuery;
union {
void *pFormParameters;
IPropertyBag *ppbFormParameters;
};
} OPENQUERYWINDOW, *LPOPENQUERYWINDOW;
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.
Hace que el cuadro de diálogo de consulta seleccione el formulario especificado por el miembro clsidDefaultForm en la inicialización.
Hace que el cuadro de diálogo oculte la barra de menús.
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 .
Hace que la consulta se ejecute cuando se muestre por primera vez el cuadro de diálogo de consulta.
Hace que el cuadro de diálogo de consulta recupere la consulta de la interfaz IPersistQuery en el miembro pPersistQuery .
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.
Indica que el miembro ppbFormParameters contiene una interfaz IPropertyBag .
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: .
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: .
Hace que el cuadro de diálogo de consulta, cuando se cierre, guarde la consulta en la interfaz IPersistQuery en el miembro pPersistQuery .
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 .
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 .
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 .
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.
Identifica el formulario de consulta de Custom Search .
Identifica el formulario de consulta Equipos .
Identifica el formulario de consulta Unidades organizativas .
Identifica el formulario de consulta Controladores de dominio .
Identifica el formulario de consulta de miembros de FRS .
Reservado.
Identifica el formulario de consulta Usuarios, Contactos y Grupos .
Identifica el formulario de consulta Impresoras .
Identifica el formulario de consulta Carpetas compartidas .
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.
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. |
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 |
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows Vista |
Servidor mínimo compatible | Windows Server 2008 |
Encabezado | cmnquery.h |
Mostrar estructuras en Servicios de dominio de Active Directory