IDebugControl3::GetDebuggeeType メソッド (dbgeng.h)

  • [アーティクル]

GetDebuggeeType メソッドは、現在のターゲットの性質を記述します。

構文

HRESULT GetDebuggeeType(
  [out] PULONG Class,
  [out] PULONG Qualifier
);

パラメーター

[out] Class

現在のターゲットの クラスを受け取ります。 次の表のいずれかの値に設定されます。

値 説明
DEBUG_CLASS_UNINITIALIZED 現在のターゲットはありません。
DEBUG_CLASS_KERNEL 現在のターゲットはカーネル モード ターゲットです。
DEBUG_CLASS_USER_WINDOWS 現在のターゲットは、ユーザー モードのターゲットです。

[out] Qualifier

ターゲットの種類の詳細を提供します。 その解釈は 、Class の値によって異なります。 クラスがDEBUG_CLASS_UNINITIALIZEDされると、 Qualifier は 0 を返します。 カーネル モード ターゲットには、次の値が適用されます。

値 説明
DEBUG_KERNEL_CONNECTION 現在のターゲットは、(COM ポート、1394 バス、または名前付きパイプを使用して) 標準の方法でデバッグされているライブ カーネルです。
DEBUG_KERNEL_LOCAL 現在のターゲットはローカル カーネルです。
DEBUG_KERNEL_EXDI_DRIVER 現在のターゲットは、eXDI ドライバーを使用して接続されたライブ カーネルです。
DEBUG_KERNEL_SMALL_DUMP 現在のターゲットはカーネル モードの Small Memory Dump ファイルです。
DEBUG_KERNEL_DUMP 現在のターゲットは、カーネル モードのカーネル メモリ ダンプ ファイルです。
DEBUG_KERNEL_FULL_DUMP 現在のターゲットは、カーネル モードの完全メモリ ダンプ ファイルです。
 

ユーザー モード ターゲットには、次の値が適用されます。

値 説明
DEBUG_USER_WINDOWS_PROCESS 現在のターゲットは、 デバッガー エンジンと同じコンピューター上のユーザー モード プロセスです。
DEBUG_USER_WINDOWS_PROCESS_SERVER 現在のターゲットは、プロセス サーバーを使用して接続されているユーザー モード プロセスです。
DEBUG_USER_WINDOWS_SMALL_DUMP 現在のターゲットは、ユーザー モードのミニダンプ ファイルです。
DEBUG_USER_WINDOWS_DUMP 現在のターゲットは、完全な User-Mode ダンプ ファイルです。

戻り値

このメソッドは、エラー値を返す場合もあります。 詳細については、「 戻り値 」を参照してください。

リターン コード 説明
S_OK
 メソッドは正常に実行されました。

要件

要件 値
対象プラットフォーム デスクトップ
Header dbgeng.h (Dbgeng.h を含む)