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

另請參閱

ADSI 錯誤碼

IDirectorySearch

IDirectorySearch：：ExecuteSearch