ADS_SCOPEENUM列舉 (iads.h)

發行項
02/29/2024

ADS_SCOPEENUM列舉會指定目錄搜尋的範圍。

Syntax

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0021 {
  ADS_SCOPE_BASE = 0,
  ADS_SCOPE_ONELEVEL = 1,
  ADS_SCOPE_SUBTREE = 2
} ADS_SCOPEENUM;

常數


`ADS_SCOPE_BASE` 值： 0 限制基底物件的搜尋。結果最多包含一個物件。
`ADS_SCOPE_ONELEVEL` 值： 1 搜尋一個立即子系層級，不包括基底物件。
`ADS_SCOPE_SUBTREE` 值： 2 搜尋整個子樹，包括所有子系和基底物件本身。

備註

如果您未明確設定搜尋範圍，則預設值為 ADS_SCOPE_SUBTREE。

因為 VBScript 無法從類型庫讀取數據，所以 VBScript 應用程式無法辨識上述定義的符號常數。請改用數值常數，在 VBScript 應用程式中設定適當的旗標。若要使用符號常數作為良好的程序設計作法，請在 VBScript 應用程式中建立這類常數的明確宣告，如這裡所示。

範例

搜尋範圍是其中一個搜尋喜好設定用戶端可以指定。下列程式代碼範例示範如何使用 ADS_SEARCHPREF_INFO 結構來完成此作業，以及 ADS_SEARCHPREF_ENUM 和這個列舉中定義的元素。

ADS_SEARCHPREF_INFO prefInfo;
prefInfo.dwSearchPref = ADS_SEARCHPREF_SEARCH_SCOPE;
prefInfo.vValue.dwType = ADSTYPE_INTEGER;
prefInfo.vValue.Integer = ADS_SCOPE_SUBTREE;