SearchResultCollection.Handle プロパティ

.NET Framework クラス ライブラリ リファレンス

SearchResultCollection.Handle プロパティ

実際の検索を実行する IDirectorySearch::ExecuteSearch メソッドによって返されるハンドルを取得します。詳細については、MSDN ライブラリ (http://msdn.microsoft.com/library) の IDirectorySearch::ExecuteSearch のトピックを参照してください。

名前空間: System.DirectoryServices
アセンブリ: System.DirectoryServices (system.directoryservices.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Handle As IntPtr

Visual Basic (使用法)

Dim instance As SearchResultCollection
Dim value As IntPtr

value = instance.Handle

C#

public IntPtr Handle { get; }

C++

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

J#

/** @property */
public IntPtr get_Handle ()

JScript

public function get Handle
 () : IntPtr

プロパティ値
このコレクションが使用する ADS_SEARCH_HANDLE 値。

解説

このコレクションを作成した DirectorySearcher は、T:System.DirectoryServices.SearchResultCollection オブジェクトで利用できるクエリ結果を作成する IDirectorySearch::ExecuteSearch メソッドを呼び出します。詳細については、MSDN ライブラリ (http://msdn.microsoft.com/library) の IDirectorySearch::ExecuteSearch のトピックを参照してください。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
SearchResultCollection クラス
SearchResultCollection メンバ
System.DirectoryServices 名前空間