Share via

PHLaunchProcess (Windows Embedded CE 6.0)

  • Article

1/6/2010

This function launches an instance of the specified application with the desired command line parameters.

Syntax

HRESULT  PHLaunchProcess(
    WCHAR* pApplicationName,
    WCHAR* pArguments,
    HPROCESS* pHandle
);

Parameters

  • pApplicationName
    [in] Name of the application as a string. It will be eventually passed to a CreateProcessW call, which is a UNICODE CreateProcess call.
  • pArguments
    [in] Arguments to pass in the eventual CreateProcessW call.
  • pHandle
    [out] Handle to the launched process.

Return Value

The function returns a variety of HRESULT values, depending on whether the call succeeded or failed. The following table shows additional possible return values.

Value Description

E_FAIL

Failure. Process could not be launched.

S_OK

Success.

E_INVALIDARG

Either the application name or the arguments passed were invalid or NULL.

Remarks

Note

This documentation applies to functionality implemented in sample code for PhCommon. For more information, see PhCommon Reference.

Requirements

Header commandapi.hpp
Library PhCommon.dll
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

PhCommon Command APIs
PhCommon Reference