Rediger

Del via


IDebugHostContextExtensibility::CloneContextForModification method (dbgmodel.h)

This method clones the current host context and returns a one-time modification interface to associate data with the context.

Syntax

HRESULT CloneContextForModification(
  IDebugHostContextExtension **extensionHandle
);

Parameters

extensionHandle

This parameter points to a IDebugHostContextExtension pointer, which is used to retrieve the host context extension. This is an Output parameter for the cloned context.

Return value

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Remarks

The CloneContextForModification method is used to clone the current host context for one time modification and eventual immutability. It is necessary to call the FinalizeContext method to finalize the cloned context and get back to the actual cloned context. After this, the returned host context becomes immutable and cannot be modified further.

Requirements

Requirement Value
Header dbgmodel.h

See also

IDebugHostContextExtensibility interface