ADS_SEARCHPREF_INFO結構 (iads.h)
ADS_SEARCHPREF_INFO結構會指定查詢喜好設定。
語法
typedef struct ads_searchpref_info {
ADS_SEARCHPREF dwSearchPref;
ADSVALUE vValue;
ADS_STATUS dwStatus;
} ADS_SEARCHPREF_INFO, *PADS_SEARCHPREF_INFO, *LPADS_SEARCHPREF_INFO;
成員
dwSearchPref
包含其中一個 ADS_SEARCHPREF_ENUM 列舉值，指定要設定的搜尋選項。
vValue
包含 ADSVALUE 結構，指定搜尋喜好設定的資料類型和值。
dwStatus
接收其中一個 ADS_STATUSENUM 列舉值，指出搜尋喜好設定的狀態。 呼叫此成員時，IDirectorySearch：：SetSearchPreference方法會填入此成員。
備註
若要設定搜尋喜好設定，請將適當的值指派給傳遞至伺服器 之ADS_SEARCHPREF_INFO 結構的欄位。 ADS_SEARCHPREF_INFO結構的vValue成員是ADSVALUE結構。 下表列出ADS_SEARCHPREF_ENUM值、ADSVALUE結構之 dwType成員的對應值，以及用於指定類型的ADSVALUE成員。
| ADS_SEARCHPREF_ENUM 價值 | ADSVALUE的dwType成員 | ADSVALUE 成員 |
|---|---|---|
| ADS_SEARCHPREF_ASYNCHRONOUS | ADSTYPE_BOOLEAN | 布林值 |
| ADS_SEARCHPREF_DEREF_ALIASES | ADSTYPE_INTEGER | 整數 |
| ADS_SEARCHPREF_SIZE_LIMIT | ADSTYPE_INTEGER | 整數 |
| ADS_SEARCHPREF_TIME_LIMIT | ADSTYPE_INTEGER | 整數 |
| ADS_SEARCHPREF_ATTRIBTYPES_ONLY | ADSTYPE_BOOLEAN | 布林值 |
| ADS_SEARCHPREF_SEARCH_SCOPE | ADSTYPE_INTEGER | 整數 |
| ADS_SEARCHPREF_TIMEOUT | ADSTYPE_INTEGER | 整數 |
| ADS_SEARCHPREF_PAGESIZE | ADSTYPE_INTEGER | 整數 |
| ADS_SEARCHPREF_PAGED_TIME_LIMIT | ADSTYPE_INTEGER | 整數 |
| ADS_SEARCHPREF_CHASE_REFERRALS | ADSTYPE_INTEGER | 整數 |
| ADS_SEARCHPREF_SORT_ON | ADSTYPE_PROV_SPECIFIC | ProviderSpecific |
| ADS_SEARCHPREF_CACHE_RESULTS | ADSTYPE_BOOLEAN | 布林值 |
| ADS_SEARCHPREF_DIRSYNC | ADSTYPE_PROV_SPECIFIC | ProviderSpecific |
| ADS_SEARCHPREF_TOMBSTONE | ADSTYPE_BOOLEAN | 布林值 |
| ADS_SEARCHPREF_VLV | ADSTYPE_PROV_SPECIFIC | ProviderSpecific |
| ADS_SEARCHPREF_ATTRIBUTE_QUERY | ADSTYPE_CASE_IGNORE_STRING | CaseIgnoreString |
| ADS_SEARCHPREF_SECURITY_MASK | ADSTYPE_INTEGER | 整數 |
| ADS_SEARCHPREF_DIRSYNC_FLAG | ADSTYPE_INTEGER | 整數 |
| ADS_SEARCHPREF_EXTENDED_DN | ADSTYPE_INTEGER | 整數 |
如需如何使用 ADS_SEARCHPREF_INFO 結構的詳細資訊和範例，請參閱 IDirectorySearch：：SetSearchPreference 方法和 ADS_SEARCHPREF_ENUM 列舉的討論。
需求
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 標頭 | iads.h |