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

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

構文

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

[out] Class

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

[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 を含む)