ICommonQuery ::OpenQueryWindow, méthode (cmnquery.h)

Article
02/28/2024

La méthode ICommonQuery ::OpenQueryWindow affiche la boîte de dialogue de requête du service d’annuaire. Cette méthode ne retourne pas tant que la boîte de dialogue n’a pas été fermée par l’utilisateur.

Syntaxe

HRESULT OpenQueryWindow(
  [in]  HWND              hwndParent,
  [in]  LPOPENQUERYWINDOW pQueryWnd,
  [out] IDataObject       **ppDataObject
);

Paramètres

[in] hwndParent

Contient le handle de la fenêtre à utiliser comme parent de la boîte de dialogue de requête. Ce paramètre peut être NULL si aucun parent n’est spécifié.

[in] pQueryWnd

Adresse d’une structure OPENQUERYWINDOW qui définit la requête à exécuter et les caractéristiques de la boîte de dialogue de requête.

[out] ppDataObject

Adresse d’un pointeur d’interface IDataObject qui reçoit les résultats de la requête. Ce paramètre reçoit uniquement des données valides si cette méthode retourne S_OK. Cet IDataObject prend en charge les formats de Presse-papiers suivants.

CFSTR_DSOBJECTNAMES

Contient des données sur les objets sélectionnés dans la boîte de dialogue de requête du service d’annuaire.

CFSTR_DSQUERYPARAMS

Contient des données sur la requête effectuée par la boîte de dialogue de requête du service d’annuaire.

CFSTR_DSQUERYSCOPE

Contient des données sur l’étendue de la requête effectuée par la boîte de dialogue de requête du service d’annuaire.

Valeur retournée

Retourne une valeur HRESULT standard, y compris les éléments suivants.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	cmnquery.h
Bibliothèque	Uuid.lib
DLL	Dsquery.dll