IDirectorySearch：：CloseSearchHandle 方法 (iads.h)
IDirectorySearch：：CloseSearchHandle 方法會關閉搜尋結果的句柄，並釋放相關聯的記憶體。
語法
HRESULT CloseSearchHandle(
[in] ADS_SEARCH_HANDLE hSearchResult
);
參數
[in] hSearchResult
提供要關閉之搜尋結果的句柄。
傳回值
此方法會傳回標準傳回值，以及下列各項：
如需其他傳回值，請參閱 ADSI 錯誤碼。
備註
實作 IDirectorySearch：：CloseSearchHandle 方法的程式也必須負責釋放 IDirectorySearch：：ExecuteSearch 方法配置的所有記憶體，包括搜尋結果和搜尋結果句柄。
呼叫端只能針對每個開啟的搜尋句柄呼叫這個方法一次，而且必須使用 IDirectorySearch：：ExecuteSearch 方法來在發出 IDirectorySearch：：CloseSearchHandle 之後取得新的搜尋句柄。
範例
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 |