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所指定的根物件不會顯示，而且根目錄的直接子對象會顯示在樹狀結構的根目錄。 如果 pszRoot
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
dwReturnFormat
包含其中一個
pUserName
Unicode 字串的指標，其中包含用於認證的用戶名稱。 如果 dwFlags 未設定 DSBI_HASCREDENTIALS 旗標，則會忽略此成員。 如果此成員 NULL，則會使用目前登入的用戶名稱。
pPassword
Unicode 字串的指標，其中包含用於認證的密碼。 如果 dwFlags 未設定 DSBI_HASCREDENTIALS 旗標，則會忽略此成員。 如果此成員 NULL，則會使用目前登入用戶的密碼。
pszObjectClass
接收所選取類別字串之 Unicode 字串緩衝區的指標。 如果 dwFlags 未設定 DSBI_RETURNOBJECTCLASS 旗標，則會忽略此成員。
cchObjectClass
包含 pszObjectClass 緩衝區 WCHAR 個字元的大小。
言論
注意
dsclient.h 標頭會根據 UNICODE 預處理器常數的定義，將 DSBROWSEINFO 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 支援的最低伺服器 | Windows Server 2008 |
| 標頭 | dsclient.h |