!handle
!handle 拡張子は、ターゲット システム内の 1 つまたはすべてのプロセスが所有するハンドルに関する情報を表示します。
ユーザー モード
!handle [Handle [UMFlags [TypeName]]]
!handle -?
カーネル モード
!handle [Handle [KMFlags [Process [TypeName]]]]
パラメーター
Handle
表示するハンドルのインデックスを指定します。 Handle が -1 の場合、またはこのパラメーターを省略した場合、デバッガーは現在のプロセスに関連付けられているすべてのハンドルのデータを表示します。 Handle が 0 の場合、デバッガーはすべてのハンドルのデータを表示します。
UMFlags
(ユーザー モードのみ) 表示内容を指定します。 このパラメータには、次のビット値の合計を指定できます。 (デフォルト値は0x1です。)
ビット0 (0x1)
ハンドルタイプの情報を表示します。
ビット1 (0x2)
ハンドルの基本情報を表示します。
ビット2 (0x4)
ハンドルネーム情報を表示します。
ビット3 (0x8)
利用可能な場合、オブジェクト固有のハンドル情報を表示します。
KMFlags
(カーネル モードのみ) 表示に表示する内容を指定します。 このパラメータには、次のビット値の合計を指定できます。 (デフォルト値は0x3です。)
ビット0 (0x1)
ハンドルの基本情報を表示します。
ビット1 (0x2)
オブジェクトに関する情報を表示します。
ビット2 (0x4)
フリーハンドルエントリを表示します。 このビットを設定せず、 Handle を省略するかゼロに設定すると、表示されるハンドルのリストには空きハンドルが含まれません。 もし Handle で単一のフリー ハンドルを指定すると、このビットを設定しなくても、そのハンドルが表示されます。
ビット4 (0x10)
現在のプロセスの代わりにカーネル ハンドル テーブルからハンドルを表示します。
ビット5 (0x20)
ハンドルをスレッド ID またはプロセス ID として解釈し、対応するカーネル オブジェクトに関する情報を表示します。
Process
(カーネルモードのみ) プロセスを指定します。 プロセス ID またはプロセス オブジェクトの 16 進アドレスを使用できます。 このパラメータは、ターゲット システム上で現在実行中のプロセスを参照する必要があります。 このパラメータが -1 の場合、または省略した場合は、現在のプロセスが使用されます。 このパラメータが 0 の場合、すべてのプロセスのハンドル情報が表示されます。
TypeName
調べたいハンドルのタイプを指定します。 このタイプに一致するハンドルのみが表示されます。 TypeName では大文字と小文字が区別されます。 有効なタイプには、イベント、セクション、ファイル、ポート、ディレクトリ、SymbolicLink、Mutant、WindowStation、セマフォ、キー、トークン、プロセス、スレッド、デスクトップ、IoCompletion、タイマー、ジョブ、および WaitablePort が含まれます。
-?
(ユーザー モードのみ) デバッガ コマンド ウィンドウにこの拡張機能のヘルプ テキストを表示します。
DLL
Windows 2000 |
Kdextx86.dll Uext.dll Ntsdexts.dll |
Windows XP以降 |
Kdexts.dll Uext.dll Ntsdexts.dll |
追加情報
ハンドルの詳細については、「 !htrace 拡張機能、Microsoft Windows SDK ドキュメント、および Microsoft Windows の内部機能 によるマーク・ルシノビッチとデビッド・。
解説
!handle 拡張子は、ユーザー モードおよびカーネル モードのライブ デバッグ中に使用できます。 この拡張子は、カーネル モード ダンプ ファイルでも使用できます。 ただし、ハンドル情報を使用して特別に作成した場合を除き、ユーザー モード ダンプ ファイルでこの拡張子を使用することはできません。 (このようなダンプ ファイルは、 .dump /mh (ダンプ ファイルの作成) コマンドを使用して作成できます コマンド。)
ライブ ユーザー モード デバッグ中に、 .closehandle (ハンドルを閉じる) コマンドを使用して 1 つ以上のハンドルを閉じることができます。
次の例は、 !handle 拡張子のユーザーモードの例です。 次のコマンドは、すべてのハンドルのリストを表示します。
0:000> !handle
Handle 4
Type Section
Handle 8
Type Event
Handle c
Type Event
Handle 10
Type Event
Handle 14
Type Directory
Handle 5c
Type File
6 Handles
Type Count
Event 3
Section 1
File 1
Directory 1
次のコマンドは、ハンドル 0x8 に関する詳細情報を表示します。
0:000> !handle 8 f
Handle 8
Type Event
Attributes 0
GrantedAccess 0x100003:
Synch
QueryState,ModifyState
HandleCount 2
PointerCount 3
Name <none>
Object Specific Information
Event Type Auto Reset
Event is Waiting
次の例は、 !handle のカーネル モードの例です。 次のコマンドは、空きハンドルを含むすべてのハンドルをリストします。
kd> !handle 0 4
processor number 0
PROCESS 80559800 SessionId: 0 Cid: 0000 Peb: 00000000 ParentCid: 0000
DirBase: 00039000 ObjectTable: e1000d60 TableSize: 380.
Image: Idle
New version of handle table at e1002000 with 380 Entries in use
0000: free handle, Entry address e1002000, Next Entry fffffffe
0004: Object: 80ed5238 GrantedAccess: 001f0fff
0008: Object: 80ed46b8 GrantedAccess: 00000000
000c: Object: e1281d00 GrantedAccess: 000f003f
0010: Object: e1013658 GrantedAccess: 00000000
......
0168: Object: ffb6c748 GrantedAccess: 00000003 (Protected)
016c: Object: ff811f90 GrantedAccess: 0012008b
0170: free handle, Entry address e10022e0, Next Entry 00000458
0174: Object: 80dfd5c8 GrantedAccess: 001f01ff
......
次のコマンドは、カーネル ハンドル テーブルのハンドル 0x14 に関する詳細情報を表示します。
kd> !handle 14 13
processor number 0
PROCESS 80559800 SessionId: 0 Cid: 0000 Peb: 00000000 ParentCid: 0000
DirBase: 00039000 ObjectTable: e1000d60 TableSize: 380.
Image: Idle
Kernel New version of handle table at e1002000 with 380 Entries in use
0014: Object: e12751d0 GrantedAccess: 0002001f
Object: e12751d0 Type: (80ec8db8) Key
ObjectHeader: e12751b8
HandleCount: 1 PointerCount: 1
Directory Object: 00000000 Name: \REGISTRY\MACHINE\SYSTEM\CONTROLSET001\CONTROL\SESSION MANAGER\EXECUTIVE
次のコマンドは、すべてのプロセスの Section オブジェクトへのすべてのハンドルに関する情報を表示します。
!handle 0 3 0 Section
...
PROCESS fffffa8004f48940
SessionId: none Cid: 0138 Peb: 7f6639bf000 ParentCid: 0004
DirBase: 10cb74000 ObjectTable: fffff8a00066f700 HandleCount: 39.
Image: smss.exe
Handle table at fffff8a00066f700 with 39 entries in use
0040: Object: fffff8a000633f00 GrantedAccess: 00000006 (Inherit) Entry: fffff8a000670100
Object: fffff8a000633f00 Type: (fffffa80035fef20) Section
ObjectHeader: fffff8a000633ed0 (new version)
HandleCount: 1 PointerCount: 262144
...
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示