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 |