Freigeben über

IDebugControl3::GetDebuggeeType-Methode (dbgeng.h)

  • Artikel

Die GetDebuggeeType-Methode beschreibt die Art des aktuellen Ziels.

Syntax

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

Parameter

[out] Class

Empfängt die -Klasse des aktuellen Ziels. Es wird auf einen der Werte in der folgenden Tabelle festgelegt.

Wert BESCHREIBUNG
DEBUG_CLASS_UNINITIALIZED Es gibt kein aktuelles Ziel.
DEBUG_CLASS_KERNEL Das aktuelle Ziel ist ein Kernelmodusziel.
DEBUG_CLASS_USER_WINDOWS Das aktuelle Ziel ist ein Benutzermodusziel.

[out] Qualifier

Enthält weitere Details zum Typ des Ziels. Seine Interpretation hängt vom Wert der Klasse ab. Wenn die Klasse DEBUG_CLASS_UNINITIALIZED ist, gibt Qualifier null zurück. Die folgenden Werte gelten für Kernelmodusziele.

Wert BESCHREIBUNG
DEBUG_KERNEL_CONNECTION Das aktuelle Ziel ist ein Live-Kernel, der standardmäßig (mithilfe eines COM-Ports, eines 1394-Busses oder einer Benannten Pipe) debuggen wird.
DEBUG_KERNEL_LOCAL Das aktuelle Ziel ist der lokale Kernel.
DEBUG_KERNEL_EXDI_DRIVER Das aktuelle Ziel ist ein Live-Kernel, der mithilfe von eXDI-Treibern verbunden ist.
DEBUG_KERNEL_SMALL_DUMP Das aktuelle Ziel ist eine Kleine Speicherabbilddatei im Kernelmodus.
DEBUG_KERNEL_DUMP Das aktuelle Ziel ist eine Kernelmodus-Speicherabbilddatei.
DEBUG_KERNEL_FULL_DUMP Das aktuelle Ziel ist eine vollständige Speicherabbilddatei im Kernelmodus.
 

Die folgenden Werte gelten für Benutzermodusziele.

Wert BESCHREIBUNG
DEBUG_USER_WINDOWS_PROCESS Das aktuelle Ziel ist ein Benutzermodusprozess auf demselben Computer wie die Debugger-Engine.
DEBUG_USER_WINDOWS_PROCESS_SERVER Das aktuelle Ziel ist ein Benutzermodusprozess, der über einen Prozessserver verbunden ist.
DEBUG_USER_WINDOWS_SMALL_DUMP Das aktuelle Ziel ist eine Minidump-Datei im Benutzermodus.
DEBUG_USER_WINDOWS_DUMP Das aktuelle Ziel ist eine vollständige User-Mode-Dumpdatei.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode war erfolgreich.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dbgeng.h (einschließlich Dbgeng.h)