IDirectorySearch::CloseSearchHandle-Methode (iads.h)

  • Artikel

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

Weitere Informationen

ADSI-Fehlercodes

Idirectorysearch

IDirectorySearch::ExecuteSearch