Estrutura DSBROWSEINFOA (dsclient.h)
A estrutura DSBROWSEINFO é usada com a função DsBrowseForContainer para fornecer e retornar dados sobre a caixa de diálogo do navegador de contêiner do Active Directory.
Sintaxe
typedef struct {
DWORD cbStruct;
HWND hwndOwner;
LPCSTR pszCaption;
LPCSTR pszTitle;
LPCWSTR pszRoot;
LPWSTR pszPath;
ULONG cchPath;
DWORD dwFlags;
BFFCALLBACK pfnCallback;
LPARAM lParam;
DWORD dwReturnFormat;
LPCWSTR pUserName;
LPCWSTR pPassword;
LPWSTR pszObjectClass;
ULONG cchObjectClass;
} DSBROWSEINFOA, *PDSBROWSEINFOA;
Membros
cbStruct
Contém o tamanho, em bytes, da estrutura DSBROWSEINFO . Isso é usado pela função DsBrowseForContainer para fins de controle de versão.
hwndOwner
Identificador da janela usada como o pai da caixa de diálogo do navegador de contêiner.
pszCaption
Ponteiro para uma cadeia de caracteres terminada em nulo que contém o legenda da caixa de diálogo. Se esse membro for NULL, um legenda padrão será usado.
pszTitle
Ponteiro para uma cadeia de caracteres terminada em nulo que contém texto adicional a ser exibido na caixa de diálogo acima do controle de árvore. Se esse membro for NULL, nenhum texto adicional será exibido.
pszRoot
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o ADsPath do contêiner colocado na raiz da caixa de diálogo. O usuário não pode navegar acima desse nível usando a caixa de diálogo.
pszPath
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que recebe o ADsPath do contêiner selecionado na caixa de diálogo. Essa cadeia de caracteres sempre será terminada em nulo mesmo se cchPath não for grande o suficiente para manter todo o caminho. Se dwFlags contiver o sinalizador DSBI_EXPANDONOPEN , esse membro conterá o ADsPath do contêiner que deve ser selecionado inicialmente na caixa de diálogo.
cchPath
Contém o tamanho, em caracteres WCHAR , do buffer pszPath .
dwFlags
Contém um conjunto de sinalizadores que definem o comportamento da caixa de diálogo. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.
DSBI_NOBUTTONS (1 (0x1))
Os + botões e - não são exibidos na caixa de diálogo.
DSBI_NOLINES (2 (0x2))
As linhas que conectam os objetos na caixa de diálogo não são exibidas.
DSBI_NOLINESATROOT (4 (0x4))
As linhas e os botões acima dos objetos raiz não são exibidos.
DSBI_CHECKBOXES (256 (0x100))
Faz com que uma caixa de marcar seja colocada ao lado de cada item na árvore. O usuário pode usar o mouse para selecionar e desmarcar essa caixa de marcar. Atualmente, isso tem uso limitado porque não há como definir ou obter o estado marcar de um item.
DSBI_NOROOT (65536 (0x10000))
O objeto raiz, especificado por pszRoot, não é exibido e os objetos filho imediatos da raiz são exibidos na raiz da árvore. Esse sinalizador não terá efeito se pszRoot for NULL ou se esse membro contiver DSBI_ENTIREDIRECTORY.
DSBI_INCLUDEHIDDEN (131072 (0x20000))
Inclua objetos ocultos na caixa de diálogo.
DSBI_EXPANDONOPEN (262144 (0x40000))
Quando a caixa de diálogo for aberta, o contêiner especificado em pszPath ficará visível e selecionado.
DSBI_ENTIREDIRECTORY (589824 (0x90000))
Inclui todos os domínios confiáveis para o servidor especificado em pszRoot ou, por padrão, o domínio no qual o usuário está conectado.
DSBI_RETURN_FORMAT (1048576 (0x100000))
Indica que o membro dwReturnFormat é válido. Se esse sinalizador não estiver definido, o formato de caminho usará como padrão X.500.
DSBI_HASCREDENTIALS (2097152 (0x200000))
pUserName e pPassword são usados para as credenciais de acesso. Caso contrário, se esse membro não contiver DSBI_SIMPLEAUTHENTICATE, a caixa de diálogo usará o contexto de segurança do thread de chamada.
DSBI_IGNORETREATASLEAF (4194304 (0x400000))
Ao determinar se o objeto é exibido na caixa de diálogo, o especificador de exibição treatAsLeaf é ignorado.
DSBI_SIMPLEAUTHENTICATE (8388608 (0x800000))
Indica que a autenticação segura não é necessária ao chamar ADsOpenObject.
DSBI_RETURNOBJECTCLASS (16777216 (0x1000000))
Indica que pszObjectClass e cchObjectClass são válidos e devem ser preenchidos.
DSBI_DONTSIGNSEAL (33554432 (0x2000000))
Indica que a assinatura e a vedação não serão usadas ao se comunicar com o serviço de diretório.
pfnCallback
Ponteiro para uma função de retorno de chamada BFFCallBack definida pelo aplicativo que recebe notificações da caixa de diálogo do navegador do contêiner. Defina esse membro como NULL se ele não for usado.
lParam
Contém um valor de 32 bits definido pelo aplicativo passado como o parâmetro lpData em todas as chamadas para pfnCallback. Esse membro será ignorado se pfnCallback for NULL.
dwReturnFormat
Contém um dos valores de ADS_FORMAT_ENUM que especifica o formato que o caminho ADSI retornado no pszPath aceitará.
pUserName
Ponteiro para uma cadeia de caracteres Unicode que contém o nome de usuário usado para as credenciais. Esse membro será ignorado se dwFlags não tiver o sinalizador DSBI_HASCREDENTIALS definido. Se esse membro for NULL, o nome de usuário conectado no momento será usado.
pPassword
Ponteiro para uma cadeia de caracteres Unicode que contém a senha usada para as credenciais. Esse membro será ignorado se dwFlags não tiver o sinalizador DSBI_HASCREDENTIALS definido. Se esse membro for NULL, a senha do usuário conectado no momento será usada.
pszObjectClass
Ponteiro para um buffer de cadeia de caracteres Unicode que recebe a cadeia de caracteres de classe do selecionado. Esse membro será ignorado se dwFlags não tiver o sinalizador DSBI_RETURNOBJECTCLASS definido.
cchObjectClass
Contém o tamanho, em caracteres WCHAR , do buffer pszObjectClass .
Comentários
Observação
O cabeçalho dsclient.h define DSBROWSEINFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
Cliente mínimo com suporte | Windows Vista |
Servidor mínimo com suporte | Windows Server 2008 |
Cabeçalho | dsclient.h |