Process.Handle プロパティ

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

Process.Handle プロパティ

関連付けられたプロセスのネイティブ ハンドルを返します。

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

Visual Basic (宣言)

Public ReadOnly Property
 Handle As IntPtr

Visual Basic (使用法)

Dim instance As Process
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

プロパティ値
関連付けられたプロセスを起動したときに、オペレーティング システムがプロセスに割り当てたハンドル。システムはこのハンドルを使用して、プロセス属性の追跡を続けます。

例外

例外の種類	条件
InvalidOperationException	プロセスがまだ起動されていません。この Process インスタンスに関連付けられたプロセスがないため、Handle プロパティを読み取ることができません。 または Process インスタンスが実行中のプロセスに割り当てられましたが、フル アクセスの権限を持つハンドルを取得するために必要なアクセス許可がありません。
NotSupportedException	リモート コンピュータで実行されているプロセスの Handle プロパティにアクセスしようとしています。

解説

アプリケーションは、多数のプロセス情報関数や制御関数のパラメータとして使用できるプロセスを識別するハンドルを取得できます。このハンドルを使用して、WaitHandle を初期化したり、ネイティブ メソッドに対してプラットフォーム呼び出しを行うことができます。

このプロセス ハンドルは、アプリケーションごとにプライベートです。プロセス ハンドルは共有できません。プロセスは、プロセス Id も持っています。これは Handle とは異なり、システム全体で一意であるため、システム全体で有効です。

Start 呼び出しで起動されたプロセスだけが、対応する Process インスタンスの Handle プロパティを設定します。

.NET Framework のセキュリティ

• SecurityPermission  (Process のメンバを呼び出すためのアクセス許可)。要求値 : LinkDemand、名前付きアクセス許可セット、FullTrust。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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

参照

関連項目
Process クラス
Process メンバ
System.Diagnostics 名前空間
Id
Process.ExitCode プロパティ
Process.ExitTime プロパティ
HandleCount
Start
Refresh