ADS_DEREFENUM列舉 (iads.h)

  • 發行項

ADS_DEREFENUM列舉會指定用來取值別名的進程。

Syntax

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0020 {
  ADS_DEREF_NEVER = 0,
  ADS_DEREF_SEARCHING = 1,
  ADS_DEREF_FINDING = 2,
  ADS_DEREF_ALWAYS = 3
} ADS_DEREFENUM;

常數

 
ADS_DEREF_NEVER
值： 0
在搜尋或尋找搜尋的基底物件時，不會取值別名。
ADS_DEREF_SEARCHING
值： 1
在搜尋基底物件的附屬物件時取值別名，但在尋找基底物件本身時不取值別名。
ADS_DEREF_FINDING
值： 2
在尋找搜尋的基底物件時取值別名，但在搜尋其附屬物件時不取值別名。
ADS_DEREF_ALWAYS
值： 3
在搜尋附屬物件時和尋找要搜尋的基底物件時，都取值別名。

備註

IDirectorySearch 介面會使用這些常數來設定別名取值行為。 如果未指定任何選項，則伺服器預設為 ADS_DEREF_NEVER。

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

範例

下列程式代碼範例示範如何設定別名取值搜尋喜好設定。 m_pSearch是指實作 IDirectorySearch 介面的物件指標。

ADS_SEARCHPREF_INFO prefInfo[1];
HRESULT hr;
 
prefInfo[0].dwSearchPref   = ADS_SEARCHPREF_DEREF_ALIASES;
prefInfo[0].vValue.dwType  = ADSTYPE_INTEGER;
prefInfo[0].vValue.Integer = ADS_DEREF_ALWAYS;
hr = m_pSearch->SetSearchPreference(prefInfo, 1);

規格需求

需求 值
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
標頭 iads.h

另請參閱

ADSI 列舉

IDirectorySearch