ADS_PREFERENCES_ENUM枚举 (iads.h)

项目
08/24/2023

ADS_PREFERENCES_ENUM 枚举指定 ADSI 的 OLE DB 提供程序的查询首选项。

语法

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0022 {
  ADSIPROP_ASYNCHRONOUS = 0,
  ADSIPROP_DEREF_ALIASES = 0x1,
  ADSIPROP_SIZE_LIMIT = 0x2,
  ADSIPROP_TIME_LIMIT = 0x3,
  ADSIPROP_ATTRIBTYPES_ONLY = 0x4,
  ADSIPROP_SEARCH_SCOPE = 0x5,
  ADSIPROP_TIMEOUT = 0x6,
  ADSIPROP_PAGESIZE = 0x7,
  ADSIPROP_PAGED_TIME_LIMIT = 0x8,
  ADSIPROP_CHASE_REFERRALS = 0x9,
  ADSIPROP_SORT_ON = 0xa,
  ADSIPROP_CACHE_RESULTS = 0xb,
  ADSIPROP_ADSIFLAG = 0xc
} ADS_PREFERENCES_ENUM;

常量


`ADSIPROP_ASYNCHRONOUS` 值： 0 请求异步搜索。
`ADSIPROP_DEREF_ALIASES` 值： 0x1 指定要解析找到对象的别名。使用 ADS_DEREFENUM 指定如何执行此操作。
`ADSIPROP_SIZE_LIMIT` 值： 0x2 指定服务器在搜索中应观察到的大小限制。大小限制是返回的对象的最大数目。零值表示没有施加大小限制。达到大小限制后，服务器将停止搜索，并返回该时间点累积的结果。
`ADSIPROP_TIME_LIMIT` 值： 0x3 指定服务器应在搜索中观察到的时间限制（以秒为单位）。零值表示没有施加时间限制。达到时间限制后，服务器将停止搜索并返回累积到该时间点的结果。
`ADSIPROP_ATTRIBTYPES_ONLY` 值： 0x4 指示搜索应仅获取已向其分配值的属性的名称。
`ADSIPROP_SEARCH_SCOPE` 值： 0x5 指定服务器应观察到的搜索范围。有关相应设置的详细信息，请参阅 ADS_SCOPEENUM 枚举。
`ADSIPROP_TIMEOUT` 值： 0x6 指定客户端等待服务器返回结果的时间限制（以秒为单位）。
`ADSIPROP_PAGESIZE` 值： 0x7 指定分页搜索中的页面大小。对于客户端的每个请求，服务器最多返回页面大小设置的对象数。
`ADSIPROP_PAGED_TIME_LIMIT` 值： 0x8 指定服务器在搜索结果页时应观察到的时间限制（以秒为单位）;这与整个搜索的时间限制相反。
`ADSIPROP_CHASE_REFERRALS` 值： 0x9 指定可以追逐引荐。如果未在服务器的命名上下文中指定根搜索，或者当搜索结果跨命名上下文 (例如，在父域) 中具有子域和搜索时，服务器会向客户端发送一条引荐消息，客户端可以选择忽略或追查该消息。默认情况下，此选项设置为 ADS_CHASE_REFERRALS_EXTERNAL。有关引荐追逐的详细信息，请参阅 ADS_CHASE_REFERRALS_ENUM。
`ADSIPROP_SORT_ON` 值： 0xa 指定服务器对结果集进行排序。使用 ADS_SORTKEY 结构指定排序键。
`ADSIPROP_CACHE_RESULTS` 值： 0xb 指定是否应在客户端缓存结果。默认情况下，ADSI 缓存结果集。关闭此选项对于大型结果集可能更理想。
`ADSIPROP_ADSIFLAG` 值： 0xc 允许 OLEDB 客户端指定绑定到服务器时要使用的绑定标志。有效值是 ADsOpenObject 允许的值。它使用属性名称“ADSI Flag”从 ADO 脚本访问。