SearchResultCollection.Handle Property

 

Gets the handle that is returned by the IDirectorySearch::ExecuteSearch method that performs the actual search. For more information, see the IDirectorySearch::ExecuteSearch topic in the MSDN Library at http://msdn.microsoft.com/library.

Namespace:   System.DirectoryServices
Assembly:  System.DirectoryServices (in System.DirectoryServices.dll)

public IntPtr Handle { get; }

Property Value

Type: System.IntPtr

The ADS_SEARCH_HANDLE value that this collection uses.

The DirectorySearcher that created this collection calls the IDirectorySearch::ExecuteSearch method, which makes the query results available to the T:System.DirectoryServices.SearchResultCollection object. For more information, see the IDirectorySearch::ExecuteSearch topic in the MSDN Library at http://msdn.microsoft.com/library.

Each time that a query is performed, a handle for the results of that query is associated with its SearchResultCollection object. This handle corresponds to the search handle in ADSI. This handle persists until you call the Dispose() method on the SearchResultCollection object, so you must call Dispose() to prevent a memory leak. The garbage collector does not free memory for this particular object.

.NET Framework
Available since 1.1
Return to top
Show: