IVsSolutionBuildManager2.StartUpdateSpecificProjectConfigurations Method

Article
02/04/2013

Use this method to maintain total control of a build process.

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

Syntax

'Declaration
Function StartUpdateSpecificProjectConfigurations ( _
    cProjs As UInteger, _
    rgpHier As IVsHierarchy(), _
    rgpcfg As IVsCfg(), _
    rgdwCleanFlags As UInteger(), _
    rgdwBuildFlags As UInteger(), _
    rgdwDeployFlags As UInteger(), _
    dwFlags As UInteger, _
    fSuppressUI As Integer _
) As Integer

int StartUpdateSpecificProjectConfigurations(
    uint cProjs,
    IVsHierarchy[] rgpHier,
    IVsCfg[] rgpcfg,
    uint[] rgdwCleanFlags,
    uint[] rgdwBuildFlags,
    uint[] rgdwDeployFlags,
    uint dwFlags,
    int fSuppressUI
)

int StartUpdateSpecificProjectConfigurations(
    [InAttribute] unsigned int cProjs, 
    [InAttribute] array<IVsHierarchy^>^ rgpHier, 
    [InAttribute] array<IVsCfg^>^ rgpcfg, 
    [InAttribute] array<unsigned int>^ rgdwCleanFlags, 
    [InAttribute] array<unsigned int>^ rgdwBuildFlags, 
    [InAttribute] array<unsigned int>^ rgdwDeployFlags, 
    [InAttribute] unsigned int dwFlags, 
    [InAttribute] int fSuppressUI
)

abstract StartUpdateSpecificProjectConfigurations : 
        cProjs:uint32 * 
        rgpHier:IVsHierarchy[] * 
        rgpcfg:IVsCfg[] * 
        rgdwCleanFlags:uint32[] * 
        rgdwBuildFlags:uint32[] * 
        rgdwDeployFlags:uint32[] * 
        dwFlags:uint32 * 
        fSuppressUI:int -> int

function StartUpdateSpecificProjectConfigurations(
    cProjs : uint, 
    rgpHier : IVsHierarchy[], 
    rgpcfg : IVsCfg[], 
    rgdwCleanFlags : uint[], 
    rgdwBuildFlags : uint[], 
    rgdwDeployFlags : uint[], 
    dwFlags : uint, 
    fSuppressUI : int
) : int

Parameters

cProjs
Type: System.UInt32
[in] Count of projects.

rgpHier
Type: array<Microsoft.VisualStudio.Shell.Interop.IVsHierarchy[]
[in] Specifies projects to build.

rgpcfg
Type: array<Microsoft.VisualStudio.Shell.Interop.IVsCfg[]
[in] A configuration in the projects specified in rgpHier.

rgdwCleanFlags
Type: array<System.UInt32[]
[in] dwOptions parameter for each corresponding project in rgpHier to StartBuildEx. Can be nulla null reference (Nothing in Visual Basic).

rgdwBuildFlags
Type: array<System.UInt32[]
[in] dwOptions for each corresponding project in rgpHier to StartBuildEx. Can be nulla null reference (Nothing in Visual Basic)

rgdwDeployFlags
Type: array<System.UInt32[]
[in] dwOptions for each corresponding project in rgpHier to StartDeploy. Can be nulla null reference (Nothing in Visual Basic).

dwFlags
Type: System.UInt32
[in] Double word containing VSSOLNBUILDUPDATEFLAGS flags.

fSuppressUI
Type: System.Int32
[in] Flag should be set true to use the default response to any dialogs, which will be suppressed; otherwise false.

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 IVsSolutionBuildManager2::StartUpdateSpecificProjectConfigurations(
   [in] UINT cProjs,
   [in, size_is(cProjs)] IVsHierarchy *rgpHier[],
   [in, size_is(cProjs)] IVsCfg *rgpCfg[],
   [in, size_is(cProjs)] DWORD rgdwCleanFlags[],
   [in, size_is(cProjs)] DWORD rgdwBuildFlags[],
   [in, size_is(cProjs)] DWORD rgdwDeployFlags[],
   [in] DWORD dwFlags, [in] BOOL fSuppressUI
);

Use this method to have total control of a build. Only specified projects and configurations will be built in the order of appearance in rgpHier; dependent projects will not be built.

The Build/Clean/Deploy flags all default to zero if the corresponding parameter array is nulla null reference (Nothing in Visual Basic).

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