IDirectorySearch::CloseSearchHandle-Methode (iads.h)
Die IDirectorySearch::CloseSearchHandle-Methode schließt das Handle mit einem Suchergebnis und gibt den zugeordneten Arbeitsspeicher frei.
Syntax
HRESULT CloseSearchHandle(
[in] ADS_SEARCH_HANDLE hSearchResult
);
Parameter
[in] hSearchResult
Stellt ein Handle für das zu schließende Suchergebnis bereit.
Rückgabewert
Diese Methode gibt die Standardrückgabewerte sowie folgendes zurück:
Weitere Rückgabewerte finden Sie unter ADSI-Fehlercodes.
Hinweise
Der Prozess, der die IDirectorySearch::CloseSearchHandle-Methode implementiert, muss auch dafür verantwortlich sein, den gesamten von der IDirectorySearch::ExecuteSearch-Methode zugeordneten Arbeitsspeicher freizugeben, einschließlich des Suchergebnisses und des Suchergebnishandles.
Der Aufrufer kann diese Methode nur einmal für jedes geöffnete Suchhandle aufrufen und muss die IDirectorySearch::ExecuteSearch-Methode verwenden, um nach der Ausgabe von IDirectorySearch::CloseSearchHandle ein neues Suchhandle abzurufen.
Beispiele
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);
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | iads.h |
| DLL | Activeds.dll; Adsldp.dll; Adsldpc.dll |