IDebugAdvanced2::Request-Methode (dbgeng.h)

Artikel
02/26/2024

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. Anforderung kann einer der Werte in der folgenden Tabelle sein. Details zu den einzelnen Vorgängen finden Sie unter dem Link in der Spalte "Anforderung".

Anforderung	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 Betriebssystemthread-ID 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 im Benutzermodus zurück.
DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS	Gibt die Standardmäßigen Prozesserstellungsoptionen 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	Liest einen Stream von einem Minidumpziel im Benutzermodus.
DEBUG_REQUEST_TARGET_CAN_DETACH	Überprüfen Sie, ob es möglich ist, dass sich die Debugger-Engine vom aktuellen Prozess trennen kann (der Prozess wird nicht mehr ausgeführt, aber nicht mehr gedebuggt).
DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE	Legen Sie die implizite Befehlszeile der Debugger-Engine fest.
DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET	Gibt den Anweisungszeiger des aktuellen Ereignisses zurück.
DEBUG_REQUEST_READ_CAPTURED_EVENT_CODE_STREAM	Gibt bis zu 64 Bytes Arbeitsspeicher am Anweisungszeiger des aktuellen Ereignisses zurück.
DEBUG_REQUEST_EXT_TYPED_DATA_ANSI	Führen Sie eine Vielzahl verschiedener Vorgänge aus, die bei der Interpretation von typisierten Daten helfen.

[in, optional] InBuffer

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

[in] InBufferSize

Gibt die Größe des Eingabepuffers InBuffer an. Wenn die Anforderung keine Eingabe erfordert, sollte InBufferSize auf 0 (null) festgelegt werden.

[out, optional] OutBuffer

Empfängt die Ausgabe dieser Methode. Der Typ und die Interpretation der Ausgabe hängen vom Request-Parameter ab. Wenn OutBufferNULL 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 hat, wird für OutBufferSize in der Regel genau diese Größe erwartet, auch wenn OutBuffer auf NULL festgelegt ist.

[out, optional] OutSize

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

Rückgabewert

Die Interpretation des Rückgabewerts hängt vom Wert des Request-Parameters 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 eine abgeschnittene Ausgabe zurückgegeben wurde.
E_INVALIDARG	Die Größe des Eingabepuffers InBufferSize oder die Größe des Ausgabepuffers OutBufferSize war nicht der erwartete Wert.