IVsBuildableProjectCfg.StartBuild Method

Article
04/22/2008

Requests that a project begin building.

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

Syntax

'Déclaration
Function StartBuild ( _
    pIVsOutputWindowPane As IVsOutputWindowPane, _
    dwOptions As UInteger _
) As Integer
'Utilisation
Dim instance As IVsBuildableProjectCfg
Dim pIVsOutputWindowPane As IVsOutputWindowPane
Dim dwOptions As UInteger
Dim returnValue As Integer

returnValue = instance.StartBuild(pIVsOutputWindowPane, _
    dwOptions)

int StartBuild(
    IVsOutputWindowPane pIVsOutputWindowPane,
    uint dwOptions
)

int StartBuild(
    [InAttribute] IVsOutputWindowPane^ pIVsOutputWindowPane, 
    [InAttribute] unsigned int dwOptions
)

function StartBuild(
    pIVsOutputWindowPane : IVsOutputWindowPane, 
    dwOptions : uint
) : int

Parameters

pIVsOutputWindowPane
Type: Microsoft.VisualStudio.Shell.Interop.IVsOutputWindowPane

[in] Pointer to the IVsOutputWindowPane interface that can be used to display status during the build operation.

dwOptions
Type: System.UInt32

[in] Options governing the build operation. The following options are valid:

VS_BUILDABLEPROJECTCFGOPTS_REBUILD

VS_BUILDABLEPROJECTCFGOPTS_BUILD_SELECTION_ONLY

VS_BUILDABLEPROJECTCFGOPTS_BUILD_ACTIVE_DOCUMENT_ONLY

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 IVsBuildableProjectCfg::StartBuild(
   [in] IVsOutputWindowPane *pIVsOutputWindowPane,
   [in] DWORD dwOptions
);

The options defined for the dwOptions parameter are used to provide the project with information about the scope of the build. VS_BUILDABLEPROJECTCFGOPTS_REBUILD requests that the project rebuild completely regardless of whether it is up to date. VS_BUILDABLEPROJECTCFGOPTS_BUILD_SELECTION_ONLY requests that only the selected items be built. VS_BUILDABLEPROJECTCFGOPTS_BUILD_ACTIVE_DOCUMENT_ONLY requests that only the most recent document to be worked on be built.

Permissions

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.

Partager via