IDebugControl::GetDebuggeeType-Methode (dbgeng.h)

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. Er 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 von Class ab. Wenn die Klasse DEBUG_CLASS_UNINITIALIZED ist, gibt der Qualifizierer 0 (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 (mit einem COM-Port, 1394-Bus oder Named Pipe) debuggt wird.
DEBUG_KERNEL_LOCAL	Das aktuelle Ziel ist der lokale Kernel.
DEBUG_KERNEL_EXDI_DRIVER	Das aktuelle Ziel ist ein Live-Kernel, der mit 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 gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Anforderungen

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