IVsMonitorUserContext.CreateEmptyContext(IVsUserContext) Method

Definition

Namespace:

Microsoft.VisualStudio.Shell.Interop

Assembly:

Microsoft.VisualStudio.Interop.dll

Package:

Microsoft.VisualStudio.Interop v17.13.40008

Creates a new context or subcontext bag on the context provider.

C++/CX

public:
 int CreateEmptyContext([Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsUserContext ^ &  ppContext);

Parameters

ppContext

IVsUserContext

[out] Pointer to the IVsUserContext interface representing the new context or subcontext bag.

Returns

Int32

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

Remarks

COM Signature

From context.idl:

cpp#

HRESULT IVsMonitorUserContext::CreateEmptyContext(  
   [out, retval] IVsUserContext ** ppContext  
);  

Use this method to create a context bag on any context provider or to link up a new subcontext bag to a context bag. You must create a context or subcontext bag before you can add context to the context provider. This method returns a pointer to the IVsUserContext interface, which is used to manage the context or subcontext bag. Once you have created an empty context bag, add attributes or keywords to the context bag by calling AddAttribute. To add attributes and keywords to a subcontext bag, call AddSubcontext.

Applies to