Export (0) Print
Expand All

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

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft