IVsOwnedProjectFactory.InitializeForOwner Method

Article
03/06/2013

Called by the project owner to tell the owned project to do all its initialization.

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

Syntax

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

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

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

abstract InitializeForOwner : 
        pszFilename:string * 
        pszLocation:string * 
        pszName:string * 
        grfCreateFlags:uint32 * 
        iidProject:Guid byref * 
        cookie:uint32 * 
        ppvProject:IntPtr byref * 
        pfCanceled:int byref -> int

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

Parameters

pszFilename
Type: System.String
[in] Pointer to a null terminated string containing the filename.

pszLocation
Type: System.String
[in] Pointer to a null terminated string containing the location.

pszName
Type: System.String
[in] Pointer to a null terminated string containing the name.

grfCreateFlags
Type: System.UInt32
[in] Specifies the create flags. Values are taken from the __VSCREATEPROJFLAGS enum.

iidProject
Type: System.Guid%
[in] Specifies iidProject.

cookie
Type: System.UInt32
[in] Cookie identifying the owned project.

ppvProject
Type: System.IntPtr%
[out] Specifies ppvProject.

pfCanceled
Type: System.Int32%
[out] Pointer to a flag indicating 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 vsshell.idl:

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

Called by the owner to tell the owned project to do all its initialization. The owned project should do all its CreateProject work in here. The cookie parameter is just the cookie that the owned project passed back in PreCreateForOwner. This allows the owned project to create its project object cookie: additional parameter over CreateProject.

.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.

Share via