IVsAggregatableProject.InitializeForOuter Method

Article
10/26/2012

Called by the owner, the outer project subtype, to have the owned project, the inner project subtype, to do its initialization work.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop.8.0 (in Microsoft.VisualStudio.Shell.Interop.8.0.dll)

Syntax

'Declaration
Function InitializeForOuter ( _
    pszFilename As String, _
    pszLocation As String, _
    pszName As String, _
    grfCreateFlags As UInteger, _
    ByRef iidProject As Guid, _
    <OutAttribute> ByRef ppvProject As IntPtr, _
    <OutAttribute> ByRef pfCanceled As Integer _
) As Integer

'Usage
Dim instance As IVsAggregatableProject 
Dim pszFilename As String 
Dim pszLocation As String 
Dim pszName As String 
Dim grfCreateFlags As UInteger 
Dim iidProject As Guid 
Dim ppvProject As IntPtr 
Dim pfCanceled As Integer 
Dim returnValue As Integer 

returnValue = instance.InitializeForOuter(pszFilename, _
    pszLocation, pszName, grfCreateFlags, _
    iidProject, ppvProject, pfCanceled)

int InitializeForOuter(
    string pszFilename,
    string pszLocation,
    string pszName,
    uint grfCreateFlags,
    ref Guid iidProject,
    out IntPtr ppvProject,
    out int pfCanceled
)

int InitializeForOuter(
    [InAttribute] String^ pszFilename, 
    [InAttribute] String^ pszLocation, 
    [InAttribute] String^ pszName, 
    [InAttribute] unsigned int grfCreateFlags, 
    [InAttribute] Guid% iidProject, 
    [OutAttribute] IntPtr% ppvProject, 
    [OutAttribute] int% pfCanceled
)

function InitializeForOuter(
    pszFilename : String, 
    pszLocation : String, 
    pszName : String, 
    grfCreateFlags : uint, 
    iidProject : Guid, 
    ppvProject : IntPtr, 
    pfCanceled : int
) : int

Parameters

pszFilename
Type: System.String

[in] Project file name of the project to be initialized.

pszLocation
Type: System.String

[out] Location of the initialized project file.

pszName
Type: System.String

[in] Pointer to a null-terminated string containing the name.

grfCreateFlags
Type: System.UInt32

[in] Controls how a project is created or opened. Values are taken from the __VSCREATEPROJFLAGS enumeration.

iidProject
Type: System.Guid%

[in] Identifier of the interface of the returned ppvProject.

ppvProject
Type: System.IntPtr%

[out, iid_is(iidProject)] Pointer to the interface specified by iidProject.

pfCanceled
Type: System.Int32%

[out] Pointer to a flag where true indicates canceled.

Return Value

Type: System.Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From vsshell80.idl:

HRESULT IVsAggregatableProject::InitializeForOuter(
   [in] LPCOLESTR pszFilename,
   [in] LPCOLESTR pszLocation,
   [in] LPCOLESTR pszName,
   [in] VSCREATEPROJFLAGS grfCreateFlags,
   [in] REFIID iidProject,
   [out, iid_is(iidProject)] void **ppvProject,
   [out] BOOL *pfCanceled
);

The owned project subtype should do all of its project creation work, similar to CreateProject, in your implementation of this method.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.