Estructura DSQUERYINITPARAMS (dsquery.h)

Artículo
08/23/2023

La estructura DSQUERYINITPARAMS describe los datos utilizados para inicializar un cuadro de diálogo examinar en la consulta del servicio de directorio.

Sintaxis

typedef struct {
  DWORD  cbStruct;
  DWORD  dwFlags;
  LPWSTR pDefaultScope;
  LPWSTR pDefaultSaveLocation;
  LPWSTR pUserName;
  LPWSTR pPassword;
  LPWSTR pServer;
} DSQUERYINITPARAMS, *LPDSQUERYINITPARAMS;

Miembros

cbStruct

Contiene el tamaño, en bytes, de esta estructura.

dwFlags

Contiene un conjunto de marcas que definen el comportamiento de la consulta. Puede ser cero o una combinación de uno o varios de los valores siguientes.

DSQPF_ENABLEADMINFEATURES

Usa características compatibles con las herramientas de administración de servicios de directorio, como Administración Especificador de visualización para menús contextuales y páginas de propiedades.

DSQPF_ENABLEADVANCEDFEATURES

Especifica características avanzadas en la instancia de IDataObject que se pasa a menús contextuales y páginas de propiedades.

DSQPF_HASCREDENTIALS

Los miembros pUserName, pPassword y pServer de esta estructura pueden especificar datos de servidor y credenciales.

DSQPF_NOCHOOSECOLUMNS

Deshabilita el elemento Elegir columnas en el menú Ver cuadro de diálogo de consulta.

DSQPF_NOSAVE

Quita el elemento Guardar búsqueda del menú Archivo del cuadro de diálogo de consulta.

DSQPF_SAVELOCATION

El miembro pDefaultSaveLocation contiene la ruta de acceso predeterminada del sistema de archivos donde se guardarán las búsquedas.

DSQPF_SHOWHIDDENOBJECTS

Hace que el cuadro de diálogo de consulta muestre objetos ocultos en la lista de resultados de la consulta.

pDefaultScope

Puntero a una cadena Unicode terminada en null que contiene ADsPath del ámbito predeterminado de la búsqueda. Establezca este miembro en NULL si no se especifica ningún ámbito de búsqueda predeterminado.

pDefaultSaveLocation

Puntero a una cadena Unicode terminada en null que contiene la ruta de acceso predeterminada del sistema de archivos donde se guardarán las búsquedas. Este miembro se omite si el miembro dwFlags no contiene DSQPF_SAVELOCATION.

pUserName

Puntero a una cadena Unicode terminada en null que contiene el nombre de usuario en la notación de dominio válida, por ejemplo, "fabrikam\jeffsmith".

pPassword

Puntero a una cadena Unicode terminada en null que contiene la contraseña del usuario especificado por el miembro pUserName .

pServer

Puntero a una cadena Unicode terminada en null que contiene el nombre del servidor desde el que se lee la lista de dominios de confianza. La lista se usa para rellenar la lista desplegable In: en el cuadro de diálogo.

Comentarios

Esta estructura es específica del controlador de consultas de CLSID_DsQuery . Esta estructura se usa para el miembro pHandlerParameters de la estructura OPENQUERYWINDOW cuando se establece CLSID_DsQuery para el miembro clsidHandler de la estructura OPENQUERYWINDOW . Para obtener más información y un ejemplo de código para usar esto y otras API relacionadas, vea ICommonQuery::OpenQueryWindow.