IVsDebuggableProjectCfg.DebugLaunch(UInt32) Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Shell.Interop.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Starts the debugger.

public:
 int DebugLaunch(System::UInt32 grfLaunch);

public:
 int DebugLaunch(unsigned int grfLaunch);

int DebugLaunch(unsigned int grfLaunch);

public int DebugLaunch (uint grfLaunch);

abstract member DebugLaunch : uint32 -> int

Public Function DebugLaunch (grfLaunch As UInteger) As Integer

Parameters

grfLaunch: UInt32

[in] Flags that determine the conditions under which to start the debugger. For valid grfLaunch values, see __VSDBGLAUNCHFLAGS.

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 IVsDebuggableProjectCfg::DebugLaunch(  
   [in] VSDBGLAUNCHFLAGS grfLaunch  
);

This method is called when the user selects the Launch menu item (F5). The set of flags specified in grfLaunch should be the same that were used in a prior call to the QueryDebugLaunch Method to determine whether or not the debugger could be launched.

Note

Implementers: this method (and its interface) can be implemented in a project to launch custom programs under the debugger. To do the actual work of launching the program controlled by a project, call LaunchDebugTargets2 Method. An example of this can be found in the My C Packagesample.

Applies to