SearchResultCollection.Handle プロパティ

定義

名前空間:

System.DirectoryServices

アセンブリ:

System.DirectoryServices.dll

パッケージ:

System.DirectoryServices v11.0.0-preview.7.26381.103

ソース:

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値。

注釈

このコレクションを作成した DirectorySearcher は、 IDirectorySearch::ExecuteSearch メソッドを呼び出します。これにより、 SearchResultCollection オブジェクトでクエリ結果を使用できるようになります。 詳細については、 IDirectorySearch::ExecuteSearch に関する 記事を参照してください。

クエリが実行されるたびに、そのクエリの結果のハンドルがその SearchResultCollection オブジェクトに関連付けられます。 このハンドルは、ADSI の検索ハンドルに対応します。 このハンドルは、Dispose() オブジェクトで SearchResultCollection メソッドを呼び出すまで保持されるため、メモリ リークを防ぐためにDispose()を呼び出す必要があります。 ガベージ コレクターは、この特定のオブジェクトのメモリを解放しません。