IDebugControl7::GetDebuggeeType2 メソッド (dbgeng.h)

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

構文

HRESULT GetDebuggeeType2(
  [in]  ULONG  Flags,
  [out] PULONG Class,
  [out] PULONG Qualifier
);

[in] Flags

デバッグ対象の型を見つける前に、GetDebuggeeType2 関数がエンジンクリティカルセクションオブジェクト (g_EngineLock) を所有する必要があるかどうかを示す単一のフラグ (DEBUG_EXEC_FLAGS_NONBLOCK) を受け取ります。

Flag が存在する場合、関数はクリティカルセクションを所有しようとします。失敗した場合は、呼び出し元のスレッドをブロックせずに続行されます。

フラグが渡されない場合、関数はエンジンクリティカルセクションが使用可能になるまで待機してから続行します。

[out] Class

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

[out] Qualifier

ターゲットの種類の詳細を提供します。その解釈は、クラスの値依存します。クラスがDEBUG_CLASS_UNINITIALIZEDされると、修飾子 0 が返されます。カーネルモードターゲットには、次の値が適用されます。

価値	形容
DEBUG_KERNEL_CONNECTION	現在のターゲットは、(COM ポート、1394 バス、または名前付きパイプを使用して) 標準的な方法でデバッグされているライブカーネルです。
DEBUG_KERNEL_LOCAL	現在のターゲットはローカルカーネルです。
DEBUG_KERNEL_EXDI_DRIVER	現在のターゲットは、eXDI ドライバーを使用して接続されたライブカーネルです。
DEBUG_KERNEL_SMALL_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 ダンプファイルです。

このメソッドは値を返しません。

要件	価値
ターゲットプラットフォームの	デスクトップ
ヘッダー	dbgeng.h