Структура 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 в байтах. Используется функцией DsBrowseForContainer для управления версиями.
hwndOwner
Дескриптор окна, используемого в качестве родительского диалогового окна браузера контейнеров.
pszCaption
Указатель на строку, завершающуюся null, которая содержит подпись диалогового окна. Если этот элемент имеет значение NULL, используется подпись по умолчанию.
pszTitle
Указатель на строку, завершающуюся нулевым значением, которая содержит дополнительный текст, отображаемый в диалоговом окне над элементом управления "Дерево". Если этот элемент имеет значение NULL, дополнительный текст не отображается.
pszRoot
Указатель на строку Юникода, завершающуюся null, которая содержит ADsPath контейнера, размещенного в корне диалогового окна. Пользователь не может перейти выше этого уровня с помощью диалогового окна.
pszPath
Указатель на строку Юникода, завершающуюся null, которая получает ADsPath контейнера, выбранного в диалоговом окне. Эта строка всегда будет заканчиваться null, даже если cchPath недостаточно велик для хранения всего пути. Если dwFlags содержит флаг DSBI_EXPANDONOPEN , этот элемент содержит ADsPath контейнера, который должен быть изначально выбран в диалоговом окне.
cchPath
Содержит размер буфера pszPath в символах WCHAR.
dwFlags
Содержит набор флагов, определяющих поведение диалогового окна. Это может быть ноль или сочетание одного или нескольких из следующих значений.
DSBI_NOBUTTONS (1 (0x1))
Кнопки + и - не отображаются в диалоговом окне.
DSBI_NOLINES (2 (0x2))
Линии, соединяющие объекты в диалоговом окне, не отображаются.
DSBI_NOLINESATROOT (4 (0x4))
Линии и кнопки над корневыми объектами не отображаются.
DSBI_CHECKBOXES (256 (0x100))
Вызывает размещение проверка поля рядом с каждым элементом в дереве. Пользователь может использовать мышь для выбора и очистки этого проверка поля. В настоящее время это использование ограничено, так как невозможно задать или получить проверка состояние элемента.
DSBI_NOROOT (65536 (0x10000))
Корневой объект, заданный параметром pszRoot, не отображается, а непосредственные дочерние объекты корня отображаются в корне дерева. Этот флаг не действует, если pszRoot имеет значение NULL или если этот элемент содержит 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))
При определении того, отображается ли объект в диалоговом окне, описатель отображения treatAsLeaf игнорируется.
DSBI_SIMPLEAUTHENTICATE (8388608 (0x800000))
Указывает, что при вызове ADsOpenObject не требуется безопасная проверка подлинности.
DSBI_RETURNOBJECTCLASS (16777216 (0x1000000))
Указывает, что pszObjectClass и cchObjectClass являются допустимыми и должны быть заполнены.
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
Содержит размер буфера pszObjectClass в символах WCHAR.
Комментарии
Примечание
Заголовок dsclient.h определяет DSBROWSEINFO в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Верхняя часть | dsclient.h |
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по