termproc

---

---

重要

このコードは時代遅れです!

Windows Terminal バージョン 1.18 の新しいプロセス モデルには、異なるアプローチが必要です。
新しい実装については、https://github.com/german-one/termwnd を参照してください。

---

---

TermProc

このリポジトリ内のコードの目的は、Conhost プロセスと Windows ターミナル プロセスを区別することと、どのターミナル インスタンスが現在のコンソール プロセスに接続されているかを判断することの両方です。サードパーティのターミナル アプリはサポートされていません。
ソース ファイルは、ほぼ同じコア コードをさまざまなプログラミング言語で転写したものです。

コードをコンパイル/実行するための最小要件:

Windows Batch 、 C 、 C++ 、 C#.Net 、 PowerShell 、およびVB.Netのソース ファイルは、 src フォルダーに公開されます。これらはすべて、ターゲット オペレーティング システムである Windows に依存します。その他の特定の依存関係を以下に示します。

ファイル	要件
*.bat	Windows PowerShell 2
*.c	C99
*.cpp	C++20
*.cs	.NET フレームワーク 4.5
*.ps1	Windows PowerShell 2
*.vb	.NET フレームワーク 4.5

関連するコード:

このリポジトリ内のソース ファイルには、検索手順の使用方法を示す完全に機能するコードが含まれています。ただし、独自のコードで使用する場合は、どの重要なコード部分を含める必要があるかを知っておくと役立つ場合があります。

ファイル	対象のコード	関心のある値
*.bat	:init_TermPidルーチンで定義されたTermPidマクロ	TermPidマクロによって返される errorlevel は、ホスト端末の PID です (エラーが発生した場合は0 )。
*.c	GetTermPid関数、構造体SYSTEM_HANDLEおよび関数GetProcBaseName 、 GetPidOfNamedProcWithOpenProcHandle	GetTermPid関数によって返される値は、ホスト端末の PID です (エラーが発生した場合は0 )。
*.cpp	名前空間termpid内のすべてと、名前saferesおよびGetProcBaseName関数	GetTermPid関数によって返される値は、ホスト端末の PID です ( 0またはエラーが発生した場合は例外)
*.cs	クラスWinTerm	WinTerm.TermProcプロパティの値は、ホスト端末プロセスを参照します (エラーが発生した場合はnullまたは例外)。
*.ps1	型参照クラスWinTerm	プロパティ[WinTerm]::TermProcの値は、ホスト端末プロセスを参照します (エラーが発生した場合は$nullまたはタイプWinTermが定義されていません)
*.vb	WinTermモジュール	WinTerm.TermProcプロパティの値は、ホスティング端末プロセスを参照します ( Nothing 、またはエラーが発生した場合は例外)

背景：

数年前、Microsoft は新しいターミナル アプリケーション、Windows Terminal の開発を開始しました。このインストールは Windows 10 で利用でき、Windows 11 にはすでに同梱されています。 2022 年 10 月の更新により、Microsoft はこれを Windows 11 のデフォルトのターミナル アプリに変更しました。
現時点では、Windows Terminal は古き良き Conhost と共存しています。ユーザーは、どれをデフォルトのターミナル アプリとして使用するかを選択できます。

これまでは、どの端末プロセスがシェル/コンソール アプリケーションに接続されているかを把握するのは簡単でした。舞台裏では常に Conhost であったため、Microsoft は、conhost プロセスを生成するプロセスを端末プロセスとして報告し、シェル アプリケーションのウィンドウをコンソール ウィンドウとして報告する Windows API を作成しました。これらはすべて技術的に間違っていますが、同時に非常に快適です。
ただし、Windows ターミナルにはそのような便利な機能は実装されていません。また、Windows ターミナルがデフォルトのターミナルとして設定されている場合、どのターミナル プロセスがシェル プロセスと通信しているかをプロセス ツリーから推測することはできません。

Process Explorer を使用すると、Windows ターミナル プロセスがシェル プロセスへのハンドルを開いていることがわかりました。これが常に当てはまると仮定して、正しいプロセス ハンドルを検索して開いているすべてのハンドルを列挙するコードを作成しようとしました。これには、文書化されていない API が必要になります。コード内に、これがどのように機能するかを大まかに説明するコメントをいくつか残しました。

各ファイルには、ウィンドウをフェードアウトしたりフェードインしたりする無関係なコードも含まれています。これは、正しいプロセスが見つかったことを証明する素晴らしい方法だと思いました。

検索手順：

これは、ソース コードで検索がどのように実装されるかを簡単に説明したものです。

1. コンソール ウィンドウのハンドルを決定します。
2. そのアイコンを取得してみてください。
   • 有効なハンドルを取得した場合、アプリケーションは Conhost ウィンドウで実行されており、ウィンドウが作成されたプロセスの PID を返します。 (Windows API は、Conhost プロセス自体ではなく、ホストされたプロセスをウィンドウの所有者として処理する特殊なケースです。)
   • ハンドルが null ポインターの場合は、Conhost ウィンドウが非表示 (ConPTY) であると想定し、Windows ターミナルがアプリケーションをホストしているという前提で検索を続行する必要があります。
3. NtQuerySystemInformation API 関数は、実行中のすべてのプロセスで開いているすべてのハンドルのスナップショットを取得するために使用されます。 (これは正式に文書化されていません。)
   • この情報は、開いているハンドルのタイプ、ハンドルを開いたプロセスの PID、および開いたハンドルを識別する疑似ハンドル (使用しない追加情報とともに) を含む構造体の配列として提供されます。
4. ループ内で配列を反復処理します。
   • 開いたハンドルのタイプが探しているタイプと一致しない場合は、次の構造に進みます。
   • 擬似ハンドルを複製します。複製されたハンドルと、非表示のコンソール ウィンドウを所有するアプリケーションへのハンドルが同じカーネル オブジェクトを指していない場合は、次の構造に進みます。
   • ハンドルを開いたプロセスの名前を取得します。名前が「Windows Terminal」でない場合は、次の構造に進みます。
   • 見つかった「Windowsターミナル」プロセスの PID を返すか、見つからなかった場合は 0 を返します。