SearchResultCollection.Handle Eigenschaft

Definition

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v9.0.0-preview.4.24266.19

Quelle:

SearchResultCollection.cs

Ruft das Handle ab, das von der IDirectorySearch::ExecuteSearch Methode zurückgegeben wird, die die eigentliche Suche ausführt. Weitere Informationen finden Sie im Artikel IDirectorySearch::ExecuteSearch.

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

public IntPtr Handle { get; }

member this.Handle : nativeint

Public ReadOnly Property Handle As IntPtr

Eigenschaftswert

IntPtr

nativeint

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 dem SearchResultCollection -Objekt zur Verfügung stellt. Weitere Informationen finden Sie im Artikel IDirectorySearch::ExecuteSearch.

Jedes Mal, wenn eine Abfrage ausgeführt wird, wird dem Objekt ein Handle für die Ergebnisse dieser Abfrage zugeordnet SearchResultCollection . Dieses Handle entspricht dem Suchhandle in ADSI. Dieses Handle bleibt erhalten, bis Sie die Dispose() -Methode für das SearchResultCollection -Objekt aufrufen. Daher müssen Sie aufrufen Dispose() , um einen Speicherverlust zu verhindern. Der Garbage Collector gibt keinen Arbeitsspeicher für dieses bestimmte Objekt frei.