Metode IDirectorySearch::CloseSearchHandle (iads.h)
Metode IDirectorySearch::CloseSearchHandle menutup handel ke hasil pencarian dan membebaskan memori terkait.
Sintaks
HRESULT CloseSearchHandle(
[in] ADS_SEARCH_HANDLE hSearchResult
);
Parameter
[in] hSearchResult
Menyediakan handel ke hasil pencarian yang akan ditutup.
Nilai kembali
Metode ini mengembalikan nilai pengembalian standar, serta yang berikut ini:
Untuk nilai pengembalian lainnya, lihat Kode Kesalahan ADSI.
Keterangan
Proses yang mengimplementasikan metode IDirectorySearch::CloseSearchHandle juga harus bertanggung jawab untuk membebaskan semua memori yang dialokasikan oleh metode IDirectorySearch::ExecuteSearch , termasuk hasil pencarian dan handel hasil pencarian.
Pemanggil dapat memanggil metode ini hanya sekali untuk setiap handel pencarian yang dibuka dan harus menggunakan metode IDirectorySearch::ExecuteSearch untuk mendapatkan handel pencarian baru setelah mengeluarkan IDirectorySearch::CloseSearchHandle.
Contoh
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);
}
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Target Platform | Windows |
| Header | iads.h |
| DLL | Activeds.dll; Adsldp.dll; Adsldpc.dll |