Структура DSBROWSEINFOA (dsclient.h)
Структура DSBROWSEINFO используется с функцией DsBrowseForContainer для предоставления и возврата данных о диалоговом окне браузера контейнеров Active Directory.
Синтаксис
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;
Члены
cbStruct
Содержит размер в байтах структуры DSBROWSEINFO. Это используется функцией
hwndOwner
Дескриптор окна, используемого в качестве родительского окна браузера контейнеров.
pszCaption
Указатель на строку, завершающуюся значением NULL, которая содержит заголовок диалогового окна. Если этот элемент NULL, используется подпись по умолчанию.
pszTitle
Указатель на строку, завершающуюся значением NULL, которая содержит дополнительный текст, отображаемый в диалоговом окне над элементом управления деревом. Если этот элемент NULL, дополнительный текст не отображается.
pszRoot
Указатель на строку Юникода, завершающую значение NULL, содержащую ADsPath контейнера, размещенного в корне диалогового окна. Пользователь не может перейти над этим уровнем с помощью диалогового окна.
pszPath
Указатель на строку Юникода, завершающую значение NULL, которая получает ADsPath контейнера, выбранного в диалоговом окне. Эта строка всегда будет завершаться значением NULL, даже если cchPath недостаточно большой, чтобы сохранить весь путь. Если dwFlags содержит флаг DSBI_EXPANDONOPEN, этот элемент содержит ADsPath контейнера, который должен быть изначально выбран в диалоговом окне.
cchPath
Содержит размер символов WCHAR буфера pszPath.
dwFlags
Содержит набор флагов, определяющих поведение диалогового окна. Это может быть ноль или сочетание одного или нескольких следующих значений.
DSBI_NOBUTTONS (1 (0x1))
Кнопки + и - не отображаются в диалоговом окне.
DSBI_NOLINES (2 (0x2))
Строки, соединяющие объекты в диалоговом окне, не отображаются.
DSBI_NOLINESATROOT (4 (0x4))
Линии и кнопки над корневыми объектами не отображаются.
DSBI_CHECKBOXES (256 (0x100))
Позволяет установить флажок рядом с каждым элементом в дереве. Пользователь может использовать мышь для выбора и очистки этого флажка. В настоящее время это ограниченное использование, так как невозможно задать или получить состояние проверки элемента.
DSBI_NOROOT (65536 (0x10000))
Корневой объект, указанный pszRoot, не отображается, а непосредственные дочерние объекты корня отображаются в корне дерева. Этот флаг не действует, если pszRootnull или если этот элемент содержит DSBI_ENTIREDIRECTORY.
DSBI_INCLUDEHIDDEN (131072 (0x20000))
Включите скрытые объекты в диалоговое окно.
DSBI_EXPANDONOPEN (262144 (0x40000))
При открытии диалогового окна контейнер, указанный в pszPath, будет отображаться и выбран.
DSBI_ENTIREDIRECTORY (589824 (0x90000))
Включает все доверенные домены на сервер, указанный в pszRoot или по умолчанию домен, в который входит пользователь.
DSBI_RETURN_FORMAT (1048576 (0x100000))
Указывает, что элемент dwReturnFormat действителен. Если этот флаг не задан, формат пути по умолчанию имеет значение X.500.
DSBI_HASCREDENTIALS (2097152 (0x200000))
pUserName и pPassword используются для учетных данных доступа. В противном случае, если этот элемент не содержит DSBI_SIMPLEAUTHENTICATE, диалоговое окно использует контекст безопасности вызывающего потока.
DSBI_IGNORETREATASLEAF (4194304 (0x400000))
При определении того, отображается ли объект в диалоговом окне, обрабатыватьAsLeaf описатель отображения игнорируется.
DSBI_SIMPLEAUTHENTICATE (8388608 (0x800000))
Указывает, что безопасная проверка подлинности не требуется при вызове ADsOpenObject.
DSBI_RETURNOBJECTCLASS (16777216 (0x1000000))
Указывает, что
DSBI_DONTSIGNSEAL (33554432 (0x2000000))
Указывает, что подписывание и печать не будут использоваться при взаимодействии со службой каталогов.
pfnCallback
Указатель на определяемую приложением функцию обратного вызова BFFCallBack, которая получает уведомления из диалогового окна браузера контейнеров. Установите для этого элемента значение NULL, если он не используется.
lParam
Содержит 32-разрядное значение, заданное приложением, в качестве параметра lpData во всех вызовах pfnCallback. Этот элемент игнорируется, если pfnCallback NULL.
dwReturnFormat
Содержит одно из значений ADS_FORMAT_ENUM, указывающее формат, который будет принимать путь ADSI, возвращенный в pszPath.
pUserName
Указатель на строку Юникода, содержащую имя пользователя, используемое для учетных данных. Этот элемент игнорируется, если dwFlags не имеет набора флагов DSBI_HASCREDENTIALS. Если этот элемент null, используется имя пользователя, вошедшего в систему.
pPassword
Указатель на строку Юникода, содержащую пароль, используемый для учетных данных. Этот элемент игнорируется, если dwFlags не имеет набора флагов DSBI_HASCREDENTIALS. Если этот элемент null, используется пароль пользователя, вошедшего в систему.
pszObjectClass
Указатель на буфер строки Юникода, который получает строку класса выбранного объекта. Этот элемент игнорируется, если dwFlags не имеет набора флагов DSBI_RETURNOBJECTCLASS.
cchObjectClass
Содержит размер в
Замечания
Заметка
Заголовок dsclient.h определяет DSBROWSEINFO в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| минимальный поддерживаемый сервер | Windows Server 2008 |
| заголовка | dsclient.h |