IVsLaunchPad2.ExecCommandEx Method

Article
02/04/2013

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: System.String
[in] Application name that is passed to CreateProcess by the environment.

pszCommandLine
Type: System.String
[in] Command line string that is passed to CreateProcess by the environment.

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

lpf
Type: System.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: System.UInt32
[in] Task item category, if lpf is set to LPF_PipeStdoutToTaskList. Values are taken from the VSTASKCATEGORY enumeration.

nTaskItemBitmap
Type: System.UInt32
[in] Task item bitmap, if lpf is set to LPF_PipeStdoutToTaskList.

pszTaskListSubcategory
Type: System.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<System.UInt32[]
[out] Value returned by process.

pbstrOutput
Type: array<System.String[]
[out] All output that was generated. Can be nulla null reference (Nothing in Visual Basic).

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