Process.MainWindowHandle プロパティ

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

Process.MainWindowHandle プロパティ

関連付けられたプロセスのメイン ウィンドウで使用するウィンドウ ハンドルを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 MainWindowHandle As IntPtr

Visual Basic (使用法)

Dim instance As Process
Dim value As IntPtr

value = instance.MainWindowHandle

C#

public IntPtr MainWindowHandle { get; }

C++

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

J#

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

JScript

public function get MainWindowHandle
 () : IntPtr

プロパティ値
関連付けられたプロセスのメイン ウィンドウで使用する、システムが生成したウィンドウ ハンドル。

例外

例外の種類	条件
InvalidOperationException	プロセスが終了したため、MainWindowHandle が定義されていません。
NotSupportedException	リモート コンピュータで実行されているプロセスの MainWindowHandle を取得しようとしています。
PlatformNotSupportedException	プラットフォームが Windows 98 または Windows Millennium Edition (Windows Me) です。Windows 98 や Windows Me でこのプロパティにアクセスするには、ProcessStartInfo.UseShellExecute を false に設定します。

解説

MainWindowHandle プロパティを取得できるのは、ローカル コンピュータで実行されているプロセスだけです。MainWindowHandle プロパティは、プロセスに関連付けられたウィンドウを一意に識別する値です。

プロセスに関連付けられたメイン ウィンドウがあるのは、そのプロセスにグラフィカル インターフェイスがある場合だけです。関連付けられたプロセスにメイン ウィンドウがない場合、MainWindowHandle 値はゼロです。プロセスの起動の直後にメイン ウィンドウ ハンドルを使用する場合は、WaitForInputIdle メソッドを使用してプロセスの起動を終了し、メイン ウィンドウ ハンドルが作成されたことを確認してください。確認しない場合、例外がスローされます。

Windows 98, Windows Millennium Edition プラットフォームメモ : ProcessStartInfo.UseShellExecute に true を設定してプロセスを開始した場合、このプロパティは、このプラットフォームでは利用できません。

.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
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Process クラス
Process メンバ
System.Diagnostics 名前空間
MainWindowTitle
Process.MainModule プロパティ