Поделиться через

Структура 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 и 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 в элементе dwState содержит допустимые данные.

DSBS_HIDDEN

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

DSBS_ROOT

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

szDisplayName[DSB_MAX_DISPLAYNAME_CHARS]

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

szIconLocation[MAX_PATH]

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

iIconResID

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

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

Комментарии

Примечание

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

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Верхняя часть dsclient.h

См. также раздел

BFFCallBack

DsBrowseForContainer

ExtractIcon