Estrutura DSBITEMA (dsclient.h)

A estrutura de DSBITEM contém dados sobre um item na caixa de diálogo do navegador de contêiner do Active Directory. Essa estrutura é passada com a notificação DSBM_QUERYINSERT para a função BFFCallBack de retorno de chamada. A caixa de diálogo do navegador de contêiner é criada com a função DsBrowseForContainer.

Sintaxe

typedef struct {
  DWORD   cbStruct;
  LPCWSTR pszADsPath;
  LPCWSTR pszClass;
  DWORD   dwMask;
  DWORD   dwState;
  DWORD   dwStateMask;
  CHAR    szDisplayName[DSB_MAX_DISPLAYNAME_CHARS];
  CHAR    szIconLocation[MAX_PATH];
  INT     iIconResID;
} DSBITEMA, *PDSBITEMA;

Membros

cbStruct

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

pszADsPath

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o ADsPath do item.

pszClass

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome da classe de objeto do item.

dwMask

Contém um conjunto de sinalizadores que indicam quais membros da estrutura contêm dados válidos. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.

DSBF_DISPLAYNAME

O membro szDisplayName do contém dados válidos.

DSBF_ICONLOCATION

Os membros szIconLocation e iIconResID contêm dados válidos.

DSBF_STATE

Os membros dwState e dwStateMask contêm dados válidos.

dwState

Contém um conjunto de sinalizadores que indicam o estado do item. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.

DSBS_CHECKED

Se esse sinalizador estiver definido, o item será selecionado. Caso contrário, o item não será selecionado. No momento, não há suporte para esse sinalizador.

DSBS_HIDDEN

Se esse sinalizador estiver definido, o item ficará oculto. Caso contrário, o item ficará visível.

DSBS_ROOT

Se esse sinalizador estiver definido, o item será um item raiz. Caso contrário, o item não é um item raiz.

dwStateMask

Contém um conjunto de sinalizadores que indicam quais sinalizadores no membro dwState contêm dados válidos. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir. Por exemplo, se dwStateMask tiver o sinalizador DSBS_HIDDEN definido e dwState não tiver o sinalizador DSBS_HIDDEN definido, o item ficará visível. Se dwStateMask não tiver o sinalizador DSBS_HIDDEN definido, o sinalizador DSBS_HIDDEN em dwState deverá ser ignorado.

DSBS_CHECKED

O sinalizador DSBS_CHECKED no membro dwState contém dados válidos.

DSBS_HIDDEN

O sinalizador DSBS_HIDDEN no membro dwState contém dados válidos.

DSBS_ROOT

O sinalizador DSBS_ROOT no membro dwState contém dados válidos.

szDisplayName[DSB_MAX_DISPLAYNAME_CHARS]

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome de exibição do item. O nome de exibição de um item pode ser alterado copiando o novo nome de exibição para esse membro, definindo o sinalizador DSBF_DISPLAYNAME no membro dwMask e retornando um valor diferente de zero de BFFCallBack.

szIconLocation[MAX_PATH]

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome de um arquivo .exe, .dllou .ico que contém o ícone a ser exibido para o item. Pode ser qualquer tipo de arquivo que possa ser passado para a função ExtractIcon. O índice desse ícone é especificado em iIconResID. Para modificar o ícone exibido para o item, copie o nome do arquivo de origem do ícone para esse membro, defina iIconResID para o índice baseado em zero do ícone, defina o sinalizador DSBF_ICONLOCATION no membro dwMask e retorne um valor diferente de zero de BFFCallBack .

iIconResID

Contém o índice baseado em zero do ícone a ser exibido para o item.

Observação Este não é o identificador de recurso do ícone.

 

Observações

Nota

O cabeçalho dsclient.h define DSBITEM como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
servidor com suporte mínimo	Windows Server 2008
cabeçalho	dsclient.h

Consulte também

BFFCallBack

DsBrowseForContainer

ExtractIcon