CeCreateProcess

This function is used to run a new program. It creates a new process and its primary thread. The new process executes the specified executable file.

CeCreateProcess is a RAPI that enables an application that is running on a desktop computer to make function calls on a Microsoft® Windows® CE–based device.

STDAPI_(BOOL) CeCreateProcess(
  LPCWSTR lpApplicationName, 
  LPCWSTR lpCommandLine, 
  LPSECURITY_ATTRIBUTES lpProcessAttributes, 
  LPSECURITY_ATTRIBUTES lpThreadAttributes, 
  BOOL bInheritHandles, 
  DWORD dwCreationFlags, 
  LPVOID lpEnvironment, 
  LPWSTR lpCurrentDirectory, 
  LPSTARTUPINFO lpStartupInfo, 
  LPPROCESS_INFORMATION lpProcessInformation 
); 

Parameters

• lpApplicationName
  [in] Long pointer to a null-terminated string that specifies the module to execute.

  The string can specify the full path and file name of the module to execute or it can specify a partial name. In the case of a partial name, the function uses the current drive and current directory to complete the specification.

• lpCommandLine
  [in] Long pointer to a null-terminated string that specifies the command line to execute.

  The lpCommandLine parameter can be NULL. In that case, the function uses the string pointed to by lpApplicationName as the command line.

  If lpCommandLine is non-NULL, lpApplicationName specifies the module to execute, and lpCommandLine specifies the command line. C runtime processes can use the argc and argv arguments.

  If lpApplicationName does not contain an extension, .EXE is assumed. If the file name ends in a period (.) with no extension, or the file name contains a path, .EXE is not appended.

  If the file name does not contain a directory path, it will search for the executable file in the following sequence:

  1. The windows (\windows) directory
  2. The root (\) directory of the device
  3. An OEM-dependent directory
  4. The OEM-defined shell (\ceshell) directory — Platform Builder users only

• lpProcessAttributes
  [in] Not supported; set to NULL.

• lpThreadAttributes
  [in] Not supported; set to NULL.

• bInheritHandles
  [in] Not supported; set to FALSE.

• dwCreationFlags
  [in] Specifies additional flags that control the priority and the creation of the process. For Windows CE versions 1.0 and later, specify either zero or the following flag.

  Value	Description
  CREATE_SUSPENDED	The primary thread of the new process is created in a suspended state, and does not run until the ResumeThread function is called.

  For Windows CE versions 2.0 and later, you can specify one of the following flags in addition to CREATE_SUSPENDED.

  Value	Description
  DEBUG_PROCESS	If this flag is set, then the calling process is treated as a debugger, and the new process is a process being debugged. Child processes of the new process are also debugged. The system notifies the debugger of all debug events that occur in the process being debugged. If you create a process with this flag set, only the calling thread — the thread that called CreateProcess — can call the WaitForDebugEvent function.
  DEBUG_ONLY_PROCESS	If this flag is set, the calling process is treated as a debugger, and the new process is a process being debugged. No child processes of the new process are debugged. The system notifies the debugger of all debug events that occur in the process being debugged.

• lpEnvironment
  [in] Not supported; set to NULL.

• lpCurrentDirectory
  [in] Not supported; set to NULL.

• lpStartupInfo
  [in] Not supported; set to NULL.

• lpProcessInformation
  [out] Long pointer to a PROCESS_INFORMATION structure that receives identification information about the new process.

Return Values

Nonzero indicates success. Zero indicates failure. To determine whether a function failed because of RAPI errors, call CeRapiGetError. To determine whether a function failed because of non-RAPI errors, call CeGetLastError.

Requirements

Pocket PC Platforms: Pocket PC 2000 and later
OS Versions: Windows CE 3.0 and later
Header: rapi.h
Library: rapi.lib

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.