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 |