IDirectorySearch：：CloseSearchHandle 方法 (iads.h)

  • 项目

IDirectorySearch：：CloseSearchHandle 方法关闭搜索结果的句柄并释放关联的内存。

语法

HRESULT CloseSearchHandle(
  [in] ADS_SEARCH_HANDLE hSearchResult
);

参数

[in] hSearchResult

提供要关闭的搜索结果的句柄。

返回值

此方法返回标准返回值以及以下内容：

有关其他返回值，请参阅 ADSI 错误代码。

注解

实现 IDirectorySearch：：CloseSearchHandle 方法的进程还必须负责释放 IDirectorySearch：：ExecuteSearch 方法分配的所有内存，包括搜索结果和搜索结果句柄。

调用方只能为每个打开的搜索句柄调用此方法一次，并且必须在发出 IDirectorySearch：：CloseSearchHandle 后使用 IDirectorySearch：：ExecuteSearch 方法获取新的搜索 句柄。

示例

ADS_SEARCH_HANDLE hSearch;
HRESULT hr;
hr = m_pSearch->ExecuteSearch(L"(&(objectCategory=user)(l=Redmond))", pszAttr, dwCount, &hSearch );
if ( SUCCEEDED(hr) )
{
   // Omit getting the data
   m_pSearch->CloseSearchHandle(hSearch);
}

要求

要求 值
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 iads.h
DLL Activeds.dll;Adsldp.dll;Adsldpc.dll

另请参阅

ADSI 错误代码

IDirectorySearch

IDirectorySearch：：ExecuteSearch