Método ICommonQuery::OpenQueryWindow (cmnquery.h)

Artigo
03/13/2024

O método ICommonQuery::OpenQueryWindow exibe a caixa de diálogo de consulta do serviço de diretório. Esse método não retorna até que a caixa de diálogo seja fechada pelo usuário.

Sintaxe

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

Parâmetros

[in] hwndParent

Contém o identificador da janela a ser usada como o pai da caixa de diálogo de consulta. Esse parâmetro poderá ser NULL se nenhum pai for especificado.

[in] pQueryWnd

Endereço de uma estrutura OPENQUERYWINDOW que define a consulta a ser executada e as características da caixa de diálogo de consulta.

[out] ppDataObject

Endereço de um ponteiro de interface IDataObject que recebe os resultados da consulta. Esse parâmetro só receberá dados válidos se esse método retornar S_OK. Esse IDataObject dá suporte aos seguintes formatos de área de transferência.

CFSTR_DSOBJECTNAMES

Contém dados sobre objetos selecionados na caixa de diálogo consulta do serviço de diretório.

CFSTR_DSQUERYPARAMS

Contém dados sobre a consulta executada pela caixa de diálogo de consulta do serviço de diretório.

CFSTR_DSQUERYSCOPE

Contém dados sobre o escopo da consulta executada pela caixa de diálogo consulta do serviço de diretório.

Retornar valor

Retorna um valor HRESULT padrão, incluindo o seguinte.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	cmnquery.h
Biblioteca	Uuid.lib
DLL	Dsquery.dll