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 |