通过

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 结尾的字符串的指针，该字符串包含树控件上方对话框中要显示的其他文本。 如果此成员 NULL，则不会显示其他文本。

pszRoot

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含放置在对话框根目录处的容器的 ADsPath。 用户无法使用对话框在此级别上导航。

pszPath

指向以 null 结尾的 Unicode 字符串的指针，该字符串接收对话框中所选容器的 ADsPath。 即使 cchPath 不足以容纳整个路径，此字符串也会始终为 null 终止。 如果 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指定的根对象，并且根的直接子对象显示在树根处。 如果 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）

确定对象是否显示在对话框中时，将忽略 treatAsLeaf 显示说明符。

DSBI_SIMPLEAUTHENTICATE（8388608（0x800000）

指示调用 ADsOpenObject时不需要安全身份验证。

DSBI_RETURNOBJECTCLASS（16777216（0x1000000）

指示 pszObjectClass 和 cchObjectClass 有效且应填充。

DSBI_DONTSIGNSEAL（33554432（0x2000000）

指示与目录服务通信时不会使用签名和密封。

pfnCallback

指向应用程序定义的 BFFCallBack 回调函数的指针，该函数接收来自容器浏览器对话框的通知。 如果未使用，请将此成员设置为 NULL。

lParam

包含作为 lpData 参数传递的应用程序定义的 32 位值，用于对 pfnCallback的所有调用。 如果 pfnCallback NULL，则忽略此成员 。

dwReturnFormat

包含一个 ADS_FORMAT_ENUM 值，该值指定 pszPath 中返回的 ADSI 路径将接受的格式。

pUserName

指向包含用于凭据的用户名的 Unicode 字符串的指针。 如果 dwFlags 没有设置 DSBI_HASCREDENTIALS 标志，则忽略此成员。 如果此成员 NULL，则使用当前登录的用户名。

pPassword

指向包含用于凭据的密码的 Unicode 字符串的指针。 如果 dwFlags 没有设置 DSBI_HASCREDENTIALS 标志，则忽略此成员。 如果此成员 NULL，则使用当前登录用户的密码。

pszObjectClass

指向接收所选类字符串的 Unicode 字符串缓冲区的指针。 如果 dwFlags 没有设置 DSBI_RETURNOBJECTCLASS 标志，则忽略此成员。

cchObjectClass

包含 pszObjectClass 缓冲区 WCHAR 个字符的大小。

言论

注意

dsclient.h 标头将 DSBROWSEINFO 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows Vista
支持的最低服务器 Windows Server 2008
标头 dsclient.h

另请参阅

ADS_FORMAT_ENUM

ADsOpenObject

BFFCallBack

DsBrowseForContainer