Estrutura DSQUERYINITPARAMS (dsquery.h)

Artigo
02/26/2024

A estrutura DSQUERYINITPARAMS descreve os dados usados para inicializar uma caixa de diálogo procurar na consulta do serviço de diretório.

Sintaxe

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

Membros

cbStruct

Contém o tamanho, em bytes, dessa estrutura.

dwFlags

Contém um conjunto de sinalizadores que definem o comportamento da consulta. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.

DSQPF_ENABLEADMINFEATURES

Usa recursos compatíveis com as ferramentas de administração do serviço de diretório, como Administração Especificador de Exibição para menus de contexto e páginas de propriedades.

DSQPF_ENABLEADVANCEDFEATURES

Especifica recursos avançados na instância IDataObject passados para menus de contexto e páginas de propriedades.

DSQPF_HASCREDENTIALS

Os membros pUserName, pPassword e pServer dessa estrutura podem especificar dados de servidor e credencial.

DSQPF_NOCHOOSECOLUMNS

Desabilita o item Escolher Colunas no menu Exibir da caixa de diálogo de consulta.

DSQPF_NOSAVE

Remove o item Salvar Pesquisa do menu Arquivo da caixa de diálogo de consulta.

DSQPF_SAVELOCATION

O membro pDefaultSaveLocation contém o caminho do sistema de arquivos padrão em que as pesquisas serão salvas.

DSQPF_SHOWHIDDENOBJECTS

Faz com que a caixa de diálogo de consulta exiba objetos ocultos na lista de resultados da consulta.

pDefaultScope

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o ADsPath do escopo padrão para a pesquisa. Defina esse membro como NULL se nenhum escopo de pesquisa padrão for especificado.

pDefaultSaveLocation

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o caminho do sistema de arquivos padrão em que as pesquisas serão salvas. Esse membro será ignorado se o membro dwFlags não contiver DSQPF_SAVELOCATION.

pUserName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome de usuário na notação de domínio válida, por exemplo, "fabrikam\jeffsmith".

pPassword

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém a senha do usuário especificada pelo membro pUserName .

pServer

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do servidor do qual a lista de domínios confiáveis é lida. A lista é usada para preencher a lista suspensa In: na caixa de diálogo.

Comentários

Essa estrutura é específica para o manipulador de consultas CLSID_DsQuery . Essa estrutura é usada para o membro pHandlerParameters da estrutura OPENQUERYWINDOW quando CLSID_DsQuery é definido para o membro clsidHandler da estrutura OPENQUERYWINDOW . Para obter mais informações e um exemplo de código para usar isso e outras APIs relacionadas, consulte ICommonQuery::OpenQueryWindow.