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 价值 ADSVALUEdwType 成员 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

另请参阅

ADSI 结构

ADSVALUE

ADS_SEARCHPREF_ENUM

ADS_STATUSENUM

IDirectorySearch::SetSearchPreference