大网数据广告活动
域与目录服务

Synchronous and Asynchronous Searches with IDirectorySearch

· 52CE 我爱测

When you perform a search using the IDirectorySearch interface, the IDirectorySearch ExecuteSearch method does not send the search request to the server.

When you perform a search using the IDirectorySearch interface, the IDirectorySearch::ExecuteSearch method does not send the search request to the server. This method only saves the search parameters. The search request is actually sent when you call IDirectorySearch::GetFirstRow or IDirectorySearch::GetNextRow.

For Active Directory searches, the primary difference between synchronous and asynchronous is when the first row of the result is returned, that is, when the first GetFirstRow or GetNextRow call returns.

In a synchronous search, if paging is not enabled, the first row is returned when the server has constructed and returned the entire result set to the client. If paging is enabled, the first row is returned when the first page of the result set is returned.

In an asynchronous search, if paging is not enabled, the first row is returned when the server has constructed the first row of the result set. If paging is enabled, the first row is returned when the first page of the result set is returned.

The default search type is synchronous. To specify an asynchronous search, set an ADS_SEARCHPREF_ASYNCHRONOUS search option with an ADSTYPE_BOOLEAN value of TRUE in the ADS_SEARCHPREF_INFO array passed to the IDirectorySearch::SetSearchPreference method. This operation is shown in the following code example.

ADS_SEARCHPREF_INFO SearchPref;
SearchPref.dwSearchPref = ADS_SEARCHPREF_ASYNCHRONOUS;
SearchPref.vValue.dwType = ADSTYPE_BOOLEAN;
SearchPref.vValue.Boolean = TRUE;

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。