SearchResultCollection.Handle-Eigenschaft

Ruft das Handle ab, das von der IDirectorySearch::ExecuteSearch-Methode zurückgegeben wird, die die eigentliche Suche ausführt. Weitere Informationen finden Sie unter dem Thema IDirectorySearch::ExecuteSearch in der MSDN Library unter https://msdn.microsoft.com/library/deu.

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

Syntax

'Declaration
Public ReadOnly Property Handle As IntPtr
'Usage
Dim instance As SearchResultCollection
Dim value As IntPtr

value = instance.Handle

public IntPtr Handle { get; }

public:
property IntPtr Handle {
    IntPtr get ();
}

/** @property */
public IntPtr get_Handle ()

public function get Handle () : IntPtr

Eigenschaftenwert

Der von dieser Auflistung verwendete ADS_SEARCH_HANDLE-Wert.

Hinweise

Der DirectorySearcher, der diese Auflistung erstellt hat, ruft die IDirectorySearch::ExecuteSearch-Methode auf, die die Abfrageergebnisse für das T:System.DirectoryServices.SearchResultCollection-Objekt verfügbar macht. Weitere Informationen finden Sie unter dem Thema IDirectorySearch::ExecuteSearch in der MSDN Library unter https://msdn.microsoft.com/library/deu.

Bei jedem Ausführen einer Abfrage wird ein Handle für die Ergebnisse der jeweiligen Abfrage dem zugehörigen SearchResultCollection-Objekt zugeordnet. Dieses Handle entspricht dem Suchhandle in ADSI. Dieses Handle wird solange beibehalten, bis die Dispose-Methode für das SearchResultCollection-Objekt aufgerufen wird. Zur Verhinderung eines Speicherverlusts muss daher Dispose aufgerufen werden. Der Garbage Collector gibt keinen Speicherplatz für dieses spezielle Objekt frei.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

SearchResultCollection-Klasse
SearchResultCollection-Member
System.DirectoryServices-Namespace