IDebugAdvanced2::Request method
The Request method performs a variety of different operations.
Syntax
HRESULT Request(
[in] ULONG Request,
[in, optional] PVOID InBuffer,
[in] ULONG InBufferSize,
[out, optional] PVOID OutBuffer,
[in] ULONG OutBufferSize,
[out, optional] PULONG OutSize
);
Parameters
Request [in]
Specifies which operation to perform. Request can be one of the values in the following table. Details of each operation can be found by following the link in the "Request" column.
| Request | Action |
|---|---|
Check the source path for a source server. |
|
Return the thread context for the stored event in a user-mode minidump file. |
|
Return the operating system thread ID for the stored event in a user-mode minidump file. |
|
Return the exception record for the stored event in a user-mode minidump file. |
|
Return the default process creation options. |
|
Set the default process creation options. |
|
Return the version of Windows that is currently running on the target. |
|
Read a stream from a user-mode minidump target. |
|
Check to see if it is possible for the debugger engine to detach from the current process (leaving the process running but no longer being debugged). |
|
Set the debugger engine's implicit command line. |
|
Return the current event's instruction pointer. |
|
Return up to 64 bytes of memory at the current event's instruction pointer. |
|
Perform a variety of different operations that aid in the interpretation of typed data. |
InBuffer [in, optional]
Specifies the input to this method. The type and interpretation of the input depends on the Request parameter.
InBufferSize [in]
Specifies the size of the input buffer InBuffer. If the request requires no input, InBufferSize should be set to zero.
OutBuffer [out, optional]
Receives the output from this method. The type and interpretation of the output depends on the Request parameter. If OutBuffer is NULL, the output is not returned.
OutBufferSize [in]
Specifies the size of the output buffer OutBufferSize. If the type of the output returned to OutBuffer has a known size, OutBufferSize is usually expected to be exactly that size, even if OutBuffer is set to NULL.
OutSize [out, optional]
Receives the size of the output returned in the output buffer OutBuffer. If OutSize is NULL, this information is not returned.
Return value
The interpretation of the return value depends on the value of the Request parameter. Unless otherwise stated, the following values may be returned.
| Return code | Description |
|---|---|
| S_OK | The method was successful. |
| S_FALSE | The method was successful. However, the output would not fit in the output buffer OutBuffer, so truncated output was returned. |
| E_INVALIDARG | The size of the input buffer InBufferSize or the size of the output buffer OutBufferSize was not the expected value. |
This method may also return error values. See Return Values for more details.
Requirements
Target platform |
Desktop |
Header |
Dbgeng.h (include Dbgeng.h) |
See also
DEBUG_REQUEST_SOURCE_PATH_HAS_SOURCE_SERVER
DEBUG_REQUEST_TARGET_EXCEPTION_CONTEXT
DEBUG_REQUEST_TARGET_EXCEPTION_THREAD
DEBUG_REQUEST_TARGET_EXCEPTION_RECORD
DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS
DEBUG_REQUEST_SET_ADDITIONAL_CREATE_OPTIONS
DEBUG_REQUEST_GET_WIN32_MAJOR_MINOR_VERSIONS
DEBUG_REQUEST_READ_USER_MINIDUMP_STREAM
DEBUG_REQUEST_TARGET_CAN_DETACH
DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE