IDebugMemoryContext2::Subtract

Subtracts the specified value from the current context and returns a new context.

Syntax

C#

int Subtract(
   ulong                    dwCount,
   out IDebugMemoryContext2 ppMemCxt
);

C++

HRESULT Subtract( 
   UINT64                 dwCount,
   IDebugMemoryContext2** ppMemCxt
);

Parameters

dwCount
[in] The number of memory bytes to decrement.

ppMemCxt
[out] Returns a new IDebugMemoryContext2 object.

Return Value

If successful, returns S_OK; otherwise, returns an error code.

Remarks

A memory context is an address, so subtracting a value from an address produces a new address that requires a new context interface.

This method must always produce a new context, even if the resulting address is outside the memory space associated with this context. The only exception to this is if no memory can be allocated for the new context or if ppMemCxt is a null value (which is an error).

See also

• IDebugMemoryContext2