SearchResultCollection.Handle 屬性

定義

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

C#
public IntPtr Handle { get; }

屬性值

IntPtr

這個集合所使用的 ADS_SEARCH_HANDLE 值。

備註

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

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

適用於

產品 版本
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10