IDebugControl7::GetDebuggeeType2-Methode (dbgeng.h)
Die GetDebuggeeType2-Methode beschreibt die Art des aktuellen Ziels.
Syntax
HRESULT GetDebuggeeType2(
[in] ULONG Flags,
[out] PULONG Class,
[out] PULONG Qualifier
);
Parameter
[in] Flags
Verwendet ein einzelnes Flag, DEBUG_EXEC_FLAGS_NONBLOCK, das angibt, ob die Funktion GetDebuggeeType2 das Modul kritische Abschnittsobjekt (g_EngineLock) besitzen soll, bevor der Debuggeetyp gefunden wird.
Wenn das Flag vorhanden ist, versucht die Funktion, den kritischen Abschnitt zu besitzen. Wenn dies fehlschlägt, wird sie fortgesetzt, ohne den Aufruferthread zu blockieren.
Wenn die Kennzeichnung nicht übergeben wird, wartet die Funktion, bis der kritische Abschnitt des Moduls verfügbar ist, bevor sie fortfahren.
[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 ist kein aktuelles Ziel vorhanden. |
| 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. Die Interpretation hängt vom Wert Classab. Wenn die Klasse DEBUG_CLASS_UNINITIALIZED ist, gibt Qualifizierer 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 gedebuggt wird (mit einem COM-Port, einem 1394-Bus oder einem benannten Pipe). |
| 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 Kernelmodusdatei für kleine Speicherabbilddateien. |
| DEBUG_KERNEL_DUMP | Das aktuelle Ziel ist eine Kernelmodus-Kernelspeicherabbilddatei. |
| 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 das Debuggermodul. |
| DEBUG_USER_WINDOWS_PROCESS_SERVER | Das aktuelle Ziel ist ein Benutzermodusprozess, der mit einem Prozessserver verbunden ist. |
| DEBUG_USER_WINDOWS_SMALL_DUMP | Das aktuelle Ziel ist eine Minidumpdatei für den Benutzermodus. |
| DEBUG_USER_WINDOWS_DUMP | Das aktuelle Ziel ist eine vollständige User-Mode Dumpdatei. |
Rückgabewert
Diese Methode gibt keinen Wert zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | dbgeng.h |