IVsSolutionBuildManager2.StartUpdateSpecificProjectConfigurations Method

Definition

Namespace:

Microsoft.VisualStudio.Shell.Interop

Assembly:

Microsoft.VisualStudio.Interop.dll

Package:

Microsoft.VisualStudio.Interop v17.12.40391

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

public:
 int StartUpdateSpecificProjectConfigurations(System::UInt32 cProjs, cli::array <Microsoft::VisualStudio::Shell::Interop::IVsHierarchy ^> ^ rgpHier, cli::array <Microsoft::VisualStudio::Shell::Interop::IVsCfg ^> ^ rgpcfg, cli::array <System::UInt32> ^ rgdwCleanFlags, cli::array <System::UInt32> ^ rgdwBuildFlags, cli::array <System::UInt32> ^ rgdwDeployFlags, System::UInt32 dwFlags, int fSuppressUI);

public:
 int StartUpdateSpecificProjectConfigurations(unsigned int cProjs, Platform::Array <Microsoft::VisualStudio::Shell::Interop::IVsHierarchy ^> ^ rgpHier, Platform::Array <Microsoft::VisualStudio::Shell::Interop::IVsCfg ^> ^ rgpcfg, Platform::Array <unsigned int> ^ rgdwCleanFlags, Platform::Array <unsigned int> ^ rgdwBuildFlags, Platform::Array <unsigned int> ^ rgdwDeployFlags, unsigned int dwFlags, int fSuppressUI);

int StartUpdateSpecificProjectConfigurations(unsigned int cProjs, std::Array <Microsoft::VisualStudio::Shell::Interop::IVsHierarchy const &> const & rgpHier, std::Array <Microsoft::VisualStudio::Shell::Interop::IVsCfg const &> const & rgpcfg, std::Array <unsigned int> const & rgdwCleanFlags, std::Array <unsigned int> const & rgdwBuildFlags, std::Array <unsigned int> const & rgdwDeployFlags, unsigned int dwFlags, int fSuppressUI);

public int StartUpdateSpecificProjectConfigurations (uint cProjs, Microsoft.VisualStudio.Shell.Interop.IVsHierarchy[] rgpHier, Microsoft.VisualStudio.Shell.Interop.IVsCfg[] rgpcfg, uint[] rgdwCleanFlags, uint[] rgdwBuildFlags, uint[] rgdwDeployFlags, uint dwFlags, int fSuppressUI);

abstract member StartUpdateSpecificProjectConfigurations : uint32 * Microsoft.VisualStudio.Shell.Interop.IVsHierarchy[] * Microsoft.VisualStudio.Shell.Interop.IVsCfg[] * uint32[] * uint32[] * uint32[] * uint32 * int -> int

Public 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

Parameters

cProjs

UInt32

[in] Count of projects.

rgpHier

IVsHierarchy[]

[in] Specifies projects to build.

rgpcfg

IVsCfg[]

[in] A configuration in the projects specified in rgpHier.

rgdwCleanFlags

UInt32[]

[in] dwOptions parameter for each corresponding project in rgpHier to StartBuildEx(UInt32, IVsOutputWindowPane, UInt32). Can be null.

rgdwBuildFlags

UInt32[]

[in] dwOptions for each corresponding project in rgpHier to StartBuildEx(UInt32, IVsOutputWindowPane, UInt32). Can be null

rgdwDeployFlags

UInt32[]

[in] dwOptions for each corresponding project in rgpHier to StartDeploy(IVsOutputWindowPane, UInt32). Can be null.

dwFlags

UInt32

[in] Double word containing VSSOLNBUILDUPDATEFLAGS flags.

fSuppressUI

Int32

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

Returns

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