IDirectorySearch 的客户端时间限制

客户端可以为服务器施加时间限制以返回结果集。 当服务器在指定时间段内无法响应查询时,客户端可以放弃搜索,稍后再试一次。

客户端请求异步搜索时,客户端时间限制首选项非常有用。 在异步搜索中,客户端发出请求,然后在等待服务器返回结果时继续执行其他任务。 服务器可以在不通知客户端的情况下脱机。 在这种情况下,客户端不会通知服务器是否仍在处理查询,或者是否不再运行。 客户端时间限制首选项使客户端可以控制此类情况。

客户端时间限制的默认值没有限制。 若要设置客户端时间限制,请在传递给 IDirectorySearch::SetSearchPreference 方法的 ADS_SEARCHPREF_INFO 数组中设置一个 ADSTYPE_INTEGERADS_SEARCHPREF_TIMEOUT 搜索选项,其中包含客户端时间限制(以秒为单位)。 客户端时间限制为零表示没有时间限制。

下面的代码示例演示如何设置客户端时间限制。

ADS_SEARCHPREF_INFO SearchPref;
SearchPref.dwSearchPref = ADS_SEARCHPREF_TIMEOUT;
SearchPref.vValue.dwType = ADSTYPE_INTEGER;
SearchPref.vValue.Integer = 10;