IVsDebuggableProjectCfg.DebugLaunch(UInt32) Method

Definition

Namespace:

Microsoft.VisualStudio.Shell.Interop

Assembly:

Microsoft.VisualStudio.Interop.dll

Package:

Microsoft.VisualStudio.Interop v17.12.40391

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.