Estrutura OPENQUERYWINDOW (cmnquery.h)

A estrutura OPENQUERYWINDOW é usada com o método ICommonQuery::OpenQueryWindow para inicializar a caixa de diálogo de consulta do serviço de diretório.

Sintaxe

typedef struct {
  DWORD         cbStruct;
  DWORD         dwFlags;
  CLSID         clsidHandler;
  LPVOID        pHandlerParameters;
  CLSID         clsidDefaultForm;
  IPersistQuery *pPersistQuery;
  union {
    void         *pFormParameters;
    IPropertyBag *ppbFormParameters;
  };
} OPENQUERYWINDOW, *LPOPENQUERYWINDOW;

Membros

cbStruct

Contém o tamanho, em bytes, da estrutura . Esse membro é usado para controle de versão e validação de parâmetro e deve ser preenchido antes de chamar ICommonQuery::OpenQueryWindow.

dwFlags

Contém um conjunto de sinalizadores que definem o comportamento da caixa de diálogo de consulta do serviço de diretório. Isso pode ser zero ou uma combinação de um ou mais dos valores listados na lista a seguir.

OQWF_DEFAULTFORM

Faz com que a caixa de diálogo de consulta selecione o formulário especificado pelo membro clsidDefaultForm na inicialização.

OQWF_HIDEMENUS

Faz com que a caixa de diálogo oculte a barra de menus.

OQWF_HIDESEARCHUI

Faz com que a caixa de diálogo de consulta seja criada sem a interface do usuário de pesquisa padrão. Isso inclui os botões Localizar Agora, Parar e Limpar Tudo .

OQWF_ISSUEONOPEN

Faz com que a consulta seja executada quando a caixa de diálogo de consulta é exibida pela primeira vez.

OQWF_LOADQUERY

Faz com que a caixa de diálogo de consulta recupere a consulta da interface IPersistQuery no membro pPersistQuery .

OQWF_OKCANCEL

Faz com que a caixa de diálogo de consulta exiba os botões OK e Cancelar , se aplicável. Os botões realmente exibidos na caixa de diálogo dependerão do formulário usado e de outros sinalizadores especificados.

OQWF_PARAMISPROPERTYBAG

Indica que o membro ppbFormParameters contém uma interface IPropertyBag .

OQWF_REMOVEFORMS

Faz com que a caixa de diálogo de consulta seja criada sem o rótulo do seletor de formulários e a lista suspensa representada pelo rótulo Localizar: .

OQWF_REMOVESCOPES

Faz com que a caixa de diálogo de consulta seja criada sem o rótulo de escopo e a lista suspensa representada pelo rótulo In: .

OQWF_SAVEQUERYONOK

Faz com que a caixa de diálogo de consulta, quando fechada, salve a consulta na interface IPersistQuery no membro pPersistQuery .

OQWF_SHOWOPTIONAL

Faz com que a caixa de diálogo de consulta exiba formulários opcionais na lista suspensa de formulários. Formulários opcionais são formulários que especificam o sinalizador CQFF_ISOPTIONAL no membro dwFlags da estrutura CQFORM .

OQWF_SINGLESELECT

Faz com que a caixa de diálogo de consulta faça a lista de resultados da consulta com seleção única.

clsidHandler

Contém um valor CLSID que especifica o manipulador de consulta a ser usado pela caixa de diálogo de consulta. O valor desse membro também determina o tipo de estrutura apontado pelo membro pHandlerParameters .

CLSID_DsQuery

Essa é a consulta de serviço de diretório padrão e a única consulta com suporte no momento.

pHandlerParameters

Ponteiro para uma estrutura que contém dados para o manipulador de consulta. O tipo de estrutura apontado por esse membro é definido pelo membro clsidHandler . A lista a seguir lista os possíveis tipos de estruturas com base no valor do membro clsidHandler .

CLSID_DsQuery

Contém um ponteiro para uma estrutura DSQUERYINITPARAMS .

clsidDefaultForm

Especifica o formulário padrão a ser exibido na caixa de diálogo de consulta. Esse membro será ignorado se dwFlags não contiver OQWF_DEFAULTFORM. Esse membro pode conter o CLSID de um formulário de consulta personalizado ou um dos formulários fornecidos pelo sistema.

CLSID_DsFindAdvanced

Identifica o formulário de consulta de Pesquisa Personalizada .

CLSID_DsFindComputer

Identifica o formulário de consulta Computadores .

CLSID_DsFindContainer

Identifica o formulário de consulta unidades organizacionais .

CLSID_DsFindDomainController

Identifica o formulário de consulta controladores de domínio .

CLSID_DsFindFrsMembers

Identifica o formulário de consulta Membros do FRS .

CLSID_DsFindObjects

Reservado.

CLSID_DsFindPeople

Identifica o formulário de consulta Usuários, Contatos e Grupos .

CLSID_DsFindPrinter

Identifica o formulário de consulta Impressoras .

CLSID_DsFindVolume

Identifica o formulário de consulta pastas compartilhadas .

CLSID_DsFindWriteableDomainController

Identifica o formulário de consulta controladores de domínio e exibe controladores de domínio graváveis.

pPersistQuery

Ponteiro para uma interface IPersistQuery usada para armazenar e recuperar dados de consulta. Esses dados pertencem à consulta em si, não aos resultados da consulta. Se dwFlags contiver OQWF_LOADQUERY, os dados de consulta serão obtidos dessa interface. Se dwFlags contiver OQWF_SAVEQUERY, os dados de consulta serão salvos nessa interface.

pFormParameters

Reservado. Ponteiro para uma estrutura ou interface que fornece dados de inicialização de parâmetro para o formulário. O conteúdo desse ponteiro é definido pela classe de formulário especificada pelo membro clsidDefaultForm .

ppbFormParameters

Ponteiro para uma interface IPropertyBag que fornece dados de inicialização de parâmetro para o formulário. O conteúdo desse recipiente de propriedades é definido pela classe de formulário especificada pelo membro clsidDefaultForm . Os formulários fornecidos pelo sistema a seguir dão suporte a esse membro.

CLSID_DsFindPrinter

Esse formulário obtém as propriedades a seguir do recipiente de propriedades.

Nome da propriedade	Descrição
printName	Contém o nome inicial da impressora.
printLocation	Contém o local inicial da impressora.
printModel	Contém o nome do modelo inicial e/ou o número da impressora.

 

CLSID_DsFindComputer

Use este formulário para especificar as funções de computador. O recipiente de propriedades deve incluir computerRole. Use uma combinação dos seguintes valores para restringir quais funções estão incluídas:

Valor	Função
0x0000	Todas as funções
0x0001	Estação de trabalho ou servidor
0x0002	Todos os controladores de domínio
0x0004	Controladores de domínio graváveis
0x0008	Controladores de Domínio somente leitura

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	cmnquery.h

Confira também

CQFORM

DSQUERYINITPARAMS

Exibir estruturas no Active Directory Domain Services

ICommonQuery::OpenQueryWindow

IPersistQuery