IVsLaunchPad2.ExecCommandEx Method

Executes a command with output displayed to an output pane in the IDE and parses the output string in a specified format.

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

Syntax

'Declaration
Function ExecCommandEx ( _
    pszApplicationName As String, _
    pszCommandLine As String, _
    pszWorkingDir As String, _
    lpf As UInteger, _
    pOutputWindowPane As IVsOutputWindowPane, _
    nTaskItemCategory As UInteger, _
    nTaskItemBitmap As UInteger, _
    pszTaskListSubcategory As String, _
    pVsLaunchPadEvents As IVsLaunchPadEvents, _
    pOutputParser As IVsLaunchPadOutputParser, _
    <OutAttribute> pdwProcessExitCode As UInteger(), _
    <OutAttribute> pbstrOutput As String() _
) As Integer

int ExecCommandEx(
    string pszApplicationName,
    string pszCommandLine,
    string pszWorkingDir,
    uint lpf,
    IVsOutputWindowPane pOutputWindowPane,
    uint nTaskItemCategory,
    uint nTaskItemBitmap,
    string pszTaskListSubcategory,
    IVsLaunchPadEvents pVsLaunchPadEvents,
    IVsLaunchPadOutputParser pOutputParser,
    uint[] pdwProcessExitCode,
    string[] pbstrOutput
)

int ExecCommandEx(
    [InAttribute] String^ pszApplicationName, 
    [InAttribute] String^ pszCommandLine, 
    [InAttribute] String^ pszWorkingDir, 
    [InAttribute] unsigned int lpf, 
    [InAttribute] IVsOutputWindowPane^ pOutputWindowPane, 
    [InAttribute] unsigned int nTaskItemCategory, 
    [InAttribute] unsigned int nTaskItemBitmap, 
    [InAttribute] String^ pszTaskListSubcategory, 
    [InAttribute] IVsLaunchPadEvents^ pVsLaunchPadEvents, 
    [InAttribute] IVsLaunchPadOutputParser^ pOutputParser, 
    [OutAttribute] array<unsigned int>^ pdwProcessExitCode, 
    [OutAttribute] array<String^>^ pbstrOutput
)

abstract ExecCommandEx : 
        pszApplicationName:string * 
        pszCommandLine:string * 
        pszWorkingDir:string * 
        lpf:uint32 * 
        pOutputWindowPane:IVsOutputWindowPane * 
        nTaskItemCategory:uint32 * 
        nTaskItemBitmap:uint32 * 
        pszTaskListSubcategory:string * 
        pVsLaunchPadEvents:IVsLaunchPadEvents * 
        pOutputParser:IVsLaunchPadOutputParser * 
        pdwProcessExitCode:uint32[] byref * 
        pbstrOutput:string[] byref -> int

function ExecCommandEx(
    pszApplicationName : String, 
    pszCommandLine : String, 
    pszWorkingDir : String, 
    lpf : uint, 
    pOutputWindowPane : IVsOutputWindowPane, 
    nTaskItemCategory : uint, 
    nTaskItemBitmap : uint, 
    pszTaskListSubcategory : String, 
    pVsLaunchPadEvents : IVsLaunchPadEvents, 
    pOutputParser : IVsLaunchPadOutputParser, 
    pdwProcessExitCode : uint[], 
    pbstrOutput : String[]
) : int

Parameters

• pszApplicationName
  Type: String

  [in] Application name that is passed to CreateProcess by the environment.

• pszCommandLine
  Type: String

  [in] Command line string that is passed to CreateProcess by the environment.

• pszWorkingDir
  Type: String

  [in] Working directory that is passed to CreateProcess by the environment. Can be nulla null reference (Nothing in Visual Basic).

• lpf
  Type: UInt32

  [in] Launch pad flags. All existing values are taken from the _LAUNCHPAD_FLAGS enumeration and all the new values are from _LAUNCHPAD_FLAGS2 enumeration

• pOutputWindowPane
  Type: Microsoft.VisualStudio.Shell.Interop.IVsOutputWindowPane

  [in] Pointer to the IVsOutputWindowPane interface created by CreatePane.

• nTaskItemCategory
  Type: UInt32

  [in] Task item category, if lpf is set to LPF_PipeStdoutToTaskList. Values are taken from the VSTASKCATEGORY enumeration.

• nTaskItemBitmap
  Type: UInt32

  [in] Task item bitmap, if lpf is set to LPF_PipeStdoutToTaskList.

• pszTaskListSubcategory
  Type: String

  [in] Task list subcategory, if lpf is set to LPF_PipeStdoutToTaskList.

• pVsLaunchPadEvents
  Type: Microsoft.VisualStudio.Shell.Interop.IVsLaunchPadEvents

  [in] Pointer to the IVsLaunchPadEvents interface

• pOutputParser
  Type: Microsoft.VisualStudio.Shell.Interop.IVsLaunchPadOutputParser

  [in] Callback for parsing of information from output (may be nulla null reference (Nothing in Visual Basic)).

• pdwProcessExitCode
  Type: array<UInt32[]

  [out] Value returned by process.

• pbstrOutput
  Type: array<String[]

  [out] All output that was generated. Can be nulla null reference (Nothing in Visual Basic).

Return Value

Type: Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From vsshell80.idl:

HRESULT IVsLaunchPad2::ExecCommandEx(
   [in] LPCOLESTR pszApplicationName,
   [in] LPCOLESTR pszCommandLine,
   [in] LPCOLESTR pszWorkingDir,
   [in] LAUNCHPAD_FLAGS2 lpf,
   [in] IVsOutputWindowPane *pOutputWindowPane,
   [in] ULONG nTaskItemCategory,
   [in] ULONG nTaskItemBitmap,
   [in] LPCOLESTR pszTaskListSubcategory,
   [in] IVsLaunchPadEvents *pVsLaunchPadEvents,
   [in] IVsLaunchPadOutputParser *pOutputParser,
   [out] DWORD *pdwProcessExitCode, [out] BSTR *pbstrOutput
);

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

See Also

Reference

IVsLaunchPad2 Interface

Microsoft.VisualStudio.Shell.Interop Namespace