Export (0) Print
Expand All

IVsSolution.AddVirtualProject Method

Adds a type of virtual project that is not created by clicking Open Project on the New menu to open the solution.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (in microsoft.visualstudio.shell.interop.dll)

int AddVirtualProject (
	[InAttribute] IVsHierarchy pHierarchy,
	[InAttribute] uint grfAddVPFlags
)
int AddVirtualProject (
	/** @attribute InAttribute() */ IVsHierarchy pHierarchy, 
	/** @attribute InAttribute() */ UInt32 grfAddVPFlags
)
function AddVirtualProject (
	pHierarchy : IVsHierarchy, 
	grfAddVPFlags : uint
) : int

Parameters

pHierarchy

[in] Pointer to the IVsHierarchy interface for the virtual project object. This object must support at least the following interfaces: IVsHierarchyIVsUIHierarchyIVsProject

grfAddVPFlags

[in] Determines whether to add a new virtual project to the Solution Explorer. For a list of grfAddVPFlags, see __VSADDVPFLAGS.

Return Value

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

COM Signature

From vsshell.idl:

HRESULT IVsSolution::AddVirtualProject(
   [in] IVsHierarchy *pHierarchy,
   [in] VSADDVPFLAGS grfAddVPFlags
);

Virtual projects are created by another facility that manages the project, and then they are added to the solution. This method makes it possible for these project hierarchies to participate in the GetProjectEnum project enumeration. You must include EPF_VIRTUAL flag in the call to GetProjectEnum if virtual projects are to be included in the enumeration. If EPF_ALL is specified, virtual projects are not included.

A virtual project is an IVsHierarchy interface item that behaves as a project in that it is a container of items (documents), but it is not a real project because it is not created by clicking Project on the New menu. Examples of virtual projects are the DataView hierarchies. These hierarchies are containers for stored procedures, tables, views, schema diagrams, and so on. By adding a DataView hierarchy as a virtual project, the OpenDocumentViaProject method can open items from DataView hierarchies. This functionality is important, as it makes possible the debugging of stored procedures.

NoteNote

Use the RemoveVirtualProject method to close a virtual project.

Community Additions

ADD
Show:
© 2014 Microsoft