Debugging Tools for Windows

SetImplicitProcessDataOffset

The SetImplicitProcessDataOffset method sets the implicit process for the current target.

HRESULT
  IDebugSystemObjects2::SetImplicitProcessDataOffset(
    IN ULONG64  Offset
    );

Parameters

Offset
Specifies the location in the target's memory address space of the data structure of the system process that is to become the implicit process for the current target. If this is zero, the implicit process for the current target is set to the default implicit process.

Return Value

S_OK
The method was successful.

This method may also return error values. See Return Values for more details.

Interface Version

SetImplicitProcessDataOffset is available in IDebugSystemObjects2 and later versions.

Comments

In kernel-mode debugging, the data structure is the KPROCESS structure for the process.

In user-mode debugging, the data structure is the process environment block (PEB) for the process.

Caution  Because it is possible to use SetImplicitThreadDataOffset to set the implicit thread independently of the implicit process, the implicit thread might not belong to the implicit process. This can cause errors if you attempt to access any of the user state for the implicit thread, because it will be incompatible with the virtual address space (specified by the implicit process).

For more information about the current implicit process, see Threads and Processes. For details on the KPROCESS and PEB structures, see Microsoft Windows Internals by David Solomon and Mark Russinovich.

Requirements

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

Build machine: CAPEBUILD