SearchResultCollection.Handle 屬性
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得執行實際搜尋的方法所 IDirectorySearch::ExecuteSearch
傳回的句柄。 如需詳細資訊,請參閱 IDirectorySearch::ExecuteSearch 一文。
public:
property IntPtr Handle { IntPtr get(); };
C#
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() 以防止記憶體流失。 垃圾收集行程不會釋放這個特定物件的記憶體。
產品 | 版本 |
---|---|
.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 |