CeCreateProcess (RAPI)

9/8/2008

Essa função é usada para executar um programa em um remoto dispositivo baseado em Windows Embedded CE. Ele cria um novo processo e seu primário segmento. O novo processo executa o arquivo executável especificado.

Syntax

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
  [no] Ponteiro longo para um seqüência de caracteres NULL-Terminated que especifica o módulo para executar.

  O seqüência de caracteres podem especificar o arquivo caminho completo e o nome do módulo para executar ou ele pode especificar um nome parcial. A maiúsculas e minúsculas de um nome parcial, a função usa o atual Diretório unidade e atual para completo da especificação.

  O lpApplicationName parâmetro deve ser não-NULL e deve incluir nome de módulo.

• lpCommandLine
  [no] Ponteiro longo para um seqüência de caracteres NULL-Terminated que especifica os argumentos linha de comando com que o aplicativo será executado.

  O lpCommandLine parâmetro pode ser NULL. Em que maiúsculas e minúsculas, a função usa o seqüência de caracteres apontado pelo lpApplicationName Como a linha de comando.

  Se lpCommandLine não-NULL, lpApplicationName Especifica o módulo para executar, e lpCommandLine Especifica os argumentos linha de comando. Os processos tempo de execução c podem usar o argc e argv Argumentos para acessar os valores linha de comando.

• lpProcessAttributes
  [no] Não com suporte; Definir como NULL.

• lpThreadAttributes
  [no] Não com suporte; Definir como NULL.

• bInheritHandles
  [no] Não com suporte; Defina como FALSE.

• dwCreationFlags
  [no] Especifica outros sinalizadores que controle a prioridade e a criação do processo. Para versões 1.0 e versões posteriores, especificar Windows Embedded CE zero ou o seguinte sinalizador.

  Valor	Descrição
  CREATE_SUSPENDED	O primário segmento do novo processo é criado em um estado suspenso e não executar até o ResumeThread função é chamado.

  Windows Embedded CE versões 2.0 e posterior, você pode especificar um do seguinte sinalizadores in addition to as edições anteriores.

  Valor	Descrição
  DEBUG_PROCESS	Se este sinalizador estiver definido, em seguida, o processo de chamada é tratada como um depurador, e o novo processo é um processo sendo depurado. Processos filho do novo processo também são depurados. O sistema notifica o depurador de todos os eventos de depuração que ocorrem no processo que está sendo depurado. Se você criar um processo com esse conjunto sinalizador, somente o segmento chamado — o segmento que chamado CreateProcess— pode chamar o WaitForDebugEvent função.
  DEBUG_ONLY_PROCESS	Se este sinalizador estiver definido, o processo de chamada é tratado como um depurador, e o novo processo é um processo sendo depurado. Nenhum processo filho do novo processo é depurado. O sistema notifica o depurador de todos os eventos de depuração que ocorrem no processo que está sendo depurado.

  Windows Embedded CE versões 3,0 e posterior, você pode especificar um do seguinte sinalizadores in addition to as edições anteriores.

  Valor	Descrição
  CREATE_NEW_CONSOLE	Se este sinalizador estiver definido, em seguida, o novo processo possui um novo console, instead of herdar console do pai de.

• lpEnvironment
  [no] Não com suporte; Definir como NULL.

• lpCurrentDirectory
  [no] Não com suporte; Definir como NULL.

• lpStartupInfo
  [no] Não com suporte; Definir como NULL.

• lpProcessInformation
  [out] Ponteiro longo para um PROCESS_INFORMATION estrutura que recebe informações de identificação sobre o novo processo.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar CeGetLastError e CeRapiGetError.

Remarks

Se lpApplicationName não contém uma extensão, .exe será adotada. Se o nome arquivo termina em um período (.) com nenhuma extensão ou nome de arquivo contém um caminho, .exe não é acrescentado.

Se o nome do arquivo não contiver um caminho Diretório, Windows Embedded CE procura o arquivo executável na seguinte seqüência:

Windows CE .NET 4.2 e posterior

1. O Diretório Windows (\Windows).
2. O Diretório raiz (\) do dispositivo.
3. Um OEM-dependente Diretório, que incluem o Windows Embedded CE Debug shell Diretório para Platform Builder usuários somente.

Windows CE 2.10 Para Windows CE .NET 4.2

1. O Diretório Windows (\Windows).
2. O Diretório raiz (\) do dispositivo.
3. Um OEM-dependente Diretório.
4. O shell OEM-defined (\ceshell) Diretório (Platform Builder usuários somente).

Windows CE 1.0 e Windows CE 2.10

1. A raiz do PC Card, se ela existir.
2. O Diretório Windows (\Windows).
3. O Diretório raiz (\) do dispositivo.

Requirements

Header	rapi.h
Library	rapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2000 and later, Smartphone 2002 and later

See Also

Reference

RAPI Functions