IDebugAdvanced3::Request-Methode (dbgeng.h)

Artikel
02/06/2025

Die Request-Methode führt eine Vielzahl verschiedener Vorgänge aus.

Syntax

HRESULT Request(
  [in]            ULONG  Request,
  [in, optional]  PVOID  InBuffer,
  [in]            ULONG  InBufferSize,
  [out, optional] PVOID  OutBuffer,
  [in]            ULONG  OutBufferSize,
  [out, optional] PULONG OutSize
);

Parameter

[in] Request

Gibt an, welcher Vorgang ausgeführt werden soll. Anforderungs- kann einer der Werte in der folgenden Tabelle sein. Details zu den einzelnen Vorgängen finden Sie unter dem Link in der Spalte "Anforderung".

Bitten	Aktion
DEBUG_REQUEST_SOURCE_PATH_HAS_SOURCE_SERVER	Überprüfen Sie den Quellpfad für einen Quellserver.
DEBUG_REQUEST_TARGET_EXCEPTION_CONTEXT	Gibt den Threadkontext für das gespeicherte Ereignis in einer Minidumpdatei im Benutzermodus zurück.
DEBUG_REQUEST_TARGET_EXCEPTION_THREAD	Gibt die Thread-ID des Betriebssystems für das gespeicherte Ereignis in einer Minidumpdatei für den Benutzermodus zurück.
DEBUG_REQUEST_TARGET_EXCEPTION_RECORD	Gibt den Ausnahmedatensatz für das gespeicherte Ereignis in einer Minidumpdatei für den Benutzermodus zurück.
DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS	Gibt die Standardoptionen für die Prozesserstellung zurück.
DEBUG_REQUEST_SET_ADDITIONAL_CREATE_OPTIONS	Legen Sie die Standardoptionen für die Prozesserstellung fest.
DEBUG_REQUEST_GET_WIN32_MAJOR_MINOR_VERSIONS	Gibt die Version von Windows zurück, die derzeit auf dem Ziel ausgeführt wird.
DEBUG_REQUEST_READ_USER_MINIDUMP_STREAM	Lesen eines Datenstroms aus einem Minidumpziel für den Benutzermodus.
DEBUG_REQUEST_TARGET_CAN_DETACH	Überprüfen Sie, ob es möglich ist, dass das Debuggermodul vom aktuellen Prozess getrennt wird (der Prozess wird ausgeführt, aber nicht mehr gedebuggt).
DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE	Legen Sie das Debuggermodulimplizite Befehlszeile fest.
DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET	Gibt den Anweisungszeiger des aktuellen Ereignisses zurück.
DEBUG_REQUEST_READ_CAPTURED_EVENT_CODE_STREAM	Zurückgeben von bis zu 64 Bytes Arbeitsspeicher am Anweisungszeiger des aktuellen Ereignisses.
DEBUG_REQUEST_EXT_TYPED_DATA_ANSI	Führen Sie eine Vielzahl verschiedener Vorgänge aus, die bei der Interpretation von typierten Daten helfen.

[in, optional] InBuffer

Gibt die Eingabe für diese Methode an. Der Typ und die Interpretation der Eingabe hängt vom parameter Request ab.

[in] InBufferSize

Gibt die Größe des Eingabepuffers InBuffer-an. Wenn die Anforderung keine Eingabe erfordert, sollte InBufferSize- auf Null festgelegt werden.

[out, optional] OutBuffer

Empfängt die Ausgabe dieser Methode. Der Typ und die Interpretation der Ausgabe hängt vom parameter Request ab. Wenn OutBuffer-NULL-ist, wird die Ausgabe nicht zurückgegeben.

[in] OutBufferSize

Gibt die Größe des Ausgabepuffers OutBufferSize-an. Wenn der Typ der an OutBuffer- zurückgegebenen Ausgabe eine bekannte Größe aufweist, wird OutBufferSize- normalerweise genau diese Größe erwartet, auch wenn OutBuffer- auf NULL-festgelegt ist.

[out, optional] OutSize

Empfängt die Größe der im Ausgabepuffer zurückgegebenen Ausgabe OutBuffer-. Wenn OutSize-NULL-ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Die Interpretation des Rückgabewerts hängt vom Wert des parameters Request ab. Sofern nicht anders angegeben, können die folgenden Werte zurückgegeben werden.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Die Ausgabe würde jedoch nicht in den Ausgabepuffer OutBuffer-passen, sodass abgeschnittene Ausgabe zurückgegeben wurde.
E_INVALIDARG	Die Größe des Eingabepuffers InBufferSize oder die Größe des Ausgabepuffers OutBufferSize nicht der erwartete Wert war.