Структура DSBITEMA (dsclient.h)

Структура DSBITEM содержит данные о элементе в диалоговом окне браузера контейнеров Active Directory. Эта структура передается с уведомлением DSBM_QUERYINSERT в функцию обратного вызова BFFCallBack. Диалоговое окно браузера контейнеров создается с помощью функции DsBrowseForContainer.

Синтаксис

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;

Члены

cbStruct

Содержит размер структуры в байтах.

pszADsPath

Указатель на строку Юникода, завершающую значение NULL, содержащую ADsPath элемента.

pszClass

Указатель на строку Юникода, завершающую значение NULL, содержащую имя класса объекта элемента.

dwMask

Содержит набор флагов, указывающих, какие элементы структуры содержат допустимые данные. Это может быть ноль или сочетание одного или нескольких следующих значений.

DSBF_DISPLAYNAME

Элемент szDisplayName содержит допустимые данные.

DSBF_ICONLOCATION

Элементы szIconLocation и iIconResID содержат допустимые данные.

DSBF_STATE

Элементы dwState dwState и dwStateMask содержат допустимые данные.

dwState

Содержит набор флагов, указывающих состояние элемента. Это может быть ноль или сочетание одного или нескольких следующих значений.

DSBS_CHECKED

Если этот флаг задан, выбран элемент. В противном случае элемент не выбран. Этот флаг в настоящее время не поддерживается.

DSBS_HIDDEN

Если этот флаг задан, элемент скрыт. В противном случае элемент отображается.

DSBS_ROOT

Если этот флаг задан, элемент является корневым элементом. В противном случае элемент не является корневым элементом.

dwStateMask

Содержит набор флагов, указывающих, какие флаги в элементе dwState содержат допустимые данные. Это может быть ноль или сочетание одного или нескольких следующих значений. Например, если dwStateMask имеет набор флагов DSBS_HIDDEN, а dwState не имеет набора флагов DSBS_HIDDEN, то элемент отображается. Если dwStateMask не имеет набора флагов DSBS_HIDDEN, необходимо игнорировать флаг DSBS_HIDDEN в dwState.

DSBS_CHECKED

Флаг DSBS_CHECKED в элементе dwStat e dwState содержит допустимые данные.

DSBS_HIDDEN

Флаг DSBS_HIDDEN в элементе dwState содержит допустимые данные.

DSBS_ROOT

Флаг DSBS_ROOT в элементе dwState содержит допустимые данные.

szDisplayName[DSB_MAX_DISPLAYNAME_CHARS]

Указатель на строку, завершающую значение NULL, содержащую отображаемое имя элемента. Отображаемое имя элемента можно изменить путем копирования нового отображаемого имени в этот элемент, задания флага DSBF_DISPLAYNAME в элементе dwMask и возврата ненулевого значения из BFFCallBack.

szIconLocation[MAX_PATH]

Указатель на строку, завершающуюся значением NULL, содержащую имя .exe, .dllили файл .ico, содержащий значок, отображаемый для элемента. Это может быть любой тип файла, который можно передать в функцию ExtractIcon. Индекс для этого значка указан в iIconResID. Чтобы изменить значок, отображаемый для элемента, скопируйте имя исходного файла значка в этот элемент, установите iIconResID в отсчитываемый от нуля индекс значка, задайте флаг DSBF_ICONLOCATION в элементе dwMask и верните ненулевое значение из BFFCallBack.

iIconResID

Содержит отсчитываемый от нуля индекс значка для отображения элемента.

примечание Это не идентификатор ресурса значка.

 

Замечания

Заметка

Заголовок dsclient.h определяет DSBITEM как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
минимальный поддерживаемый сервер	Windows Server 2008
заголовка	dsclient.h

См. также

BFFCallBack

DsBrowseForContainer

ExtractIcon