IVsDebuggableProjectCfg.QueryDebugLaunch Method

Article
03/06/2013

Determines whether the debugger can be launched, given the state of the launch flags.

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

Syntax

'Declaration
Function QueryDebugLaunch ( _
    grfLaunch As UInteger, _
    <OutAttribute> ByRef pfCanLaunch As Integer _
) As Integer

int QueryDebugLaunch(
    uint grfLaunch,
    out int pfCanLaunch
)

int QueryDebugLaunch(
    [InAttribute] unsigned int grfLaunch, 
    [OutAttribute] int% pfCanLaunch
)

abstract QueryDebugLaunch : 
        grfLaunch:uint32 * 
        pfCanLaunch:int byref -> int

function QueryDebugLaunch(
    grfLaunch : uint, 
    pfCanLaunch : int
) : int

Parameters

grfLaunch
Type: System.UInt32
[in] Flags that determine the conditions under which to launch the debugger. For valid grfLaunch values, see __VSDBGLAUNCHFLAGS.

pfCanLaunch
Type: System.Int32%
[out] Pointer to a flag that is set to true if the debugger can be launched and false otherwise.

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 IVsDebuggableProjectCfg::QueryDebugLaunch(
   [in] VSDBGLAUNCHFLAGS grfLaunch,
   [out] BOOL *pfCanLaunch
);

This method determines whether or not the debugger can be launched and the Launch menu item enabled. When QueryDebugLaunch sets pfCanLaunch to true and the user selects the Launch menu item, the project calls DebugLaunch with the same set of flags that were used to call QueryDebugLaunch.

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

Share via