Structure DSQUERYINITPARAMS (dsquery.h)

Article
02/29/2024

La structure DSQUERYINITPARAMS décrit les données utilisées pour initialiser une boîte de dialogue parcourir dans la requête du service d’annuaire.

Syntaxe

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

Membres

cbStruct

Contient la taille, en octets, de cette structure.

dwFlags

Contient un ensemble d’indicateurs qui définissent le comportement de requête. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.

DSQPF_ENABLEADMINFEATURES

Utilise les fonctionnalités prises en charge par les outils d’administration du service d’annuaire, telles que le spécificateur d’affichage Administration pour les menus contextuels et les pages de propriétés.

DSQPF_ENABLEADVANCEDFEATURES

Spécifie les fonctionnalités avancées dans iDataObject instance passées aux menus contextuels et aux pages de propriétés.

DSQPF_HASCREDENTIALS

Les membres pUserName, pPassword et pServer de cette structure peuvent spécifier des données de serveur et d’informations d’identification.

DSQPF_NOCHOOSECOLUMNS

Désactive l’élément Choisir des colonnes dans le menu Affichage de la boîte de dialogue de requête.

DSQPF_NOSAVE

Supprime l’élément Enregistrer la recherche du menu Fichier de la boîte de dialogue de requête.

DSQPF_SAVELOCATION

Le membre pDefaultSaveLocation contient le chemin d’accès par défaut au système de fichiers où les recherches seront enregistrées.

DSQPF_SHOWHIDDENOBJECTS

Entraîne l’affichage des objets masqués dans la liste des résultats de la requête dans la boîte de dialogue de requête.

pDefaultScope

Pointeur vers une chaîne Unicode terminée par un caractère Null qui contient l’ADsPath de l’étendue par défaut de la recherche. Définissez ce membre sur NULL si aucune étendue de recherche par défaut n’est spécifiée.

pDefaultSaveLocation

Pointeur vers une chaîne Unicode terminée par null qui contient le chemin d’accès du système de fichiers par défaut où les recherches seront enregistrées. Ce membre est ignoré si le membre dwFlags ne contient pas de DSQPF_SAVELOCATION.

pUserName

Pointeur vers une chaîne Unicode terminée par null qui contient le nom d’utilisateur dans la notation de domaine valide, par exemple, « fabrikam\jeffsmith ».

pPassword

Pointeur vers une chaîne Unicode terminée par null qui contient le mot de passe de l’utilisateur spécifié par le membre pUserName .

pServer

Pointeur vers une chaîne Unicode terminée par un caractère Null qui contient le nom du serveur à partir duquel la liste des domaines approuvés est lue. La liste est utilisée pour remplir la liste déroulante In : dans la boîte de dialogue.

Remarques

Cette structure est spécifique au gestionnaire de requêtes CLSID_DsQuery . Cette structure est utilisée pour le membre pHandlerParameters de la structure OPENQUERYWINDOW lorsque CLSID_DsQuery est défini pour le membre clsidHandler de la structure OPENQUERYWINDOW . Pour plus d’informations et un exemple de code pour l’utilisation de cette API et d’autres API associées, consultez ICommonQuery ::OpenQueryWindow.