SearchResultCollection.Handle 屬性

定義

命名空間:

System.DirectoryServices

組件:

System.DirectoryServices.dll

套件:

System.DirectoryServices v8.0.0

來源:

SearchResultCollection.cs

取得執行實際搜尋的方法所 IDirectorySearch::ExecuteSearch 傳回的句柄。 如需詳細資訊，請參閱 IDirectorySearch::ExecuteSearch 一文。

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

public IntPtr Handle { get; }

member this.Handle : nativeint

Public ReadOnly Property Handle As IntPtr

屬性值

IntPtr

nativeint

這個集合所使用的 ADS_SEARCH_HANDLE 值。

備註

建立這個集合的 IDirectorySearch::ExecuteSearch 會DirectorySearcher呼叫 方法，讓查詢結果可供 SearchResultCollection 物件使用。 如需詳細資訊，請參閱 IDirectorySearch::ExecuteSearch 一文。

每次執行查詢時，該查詢結果的句柄都會與其 SearchResultCollection 對象相關聯。 這個句柄對應於 ADSI 中的搜尋句柄。 這個句柄會持續存在，直到您在 物件上SearchResultCollection呼叫 Dispose() 方法為止，因此您必須呼叫 Dispose() 以防止記憶體流失。 垃圾收集行程不會釋放這個特定物件的記憶體。