CreateProcess

Prototypes


LONG CreateProcess(LPCSTR NomProgramme, LPCSTR Parametres, LPSECURITY_ATTRIBUTES AttributsProcessus, LPSECURITY_ATTRIBUTES AttributsThread, BOOL Heritage, DWORD Options, PVOID Environnement, LPCSTR RepertoireInitial, LPSTARTUPINFOW InformationsDemarrage, LPPROCESS_INFORMATION InformationsProcessus);

Description

Crée un nouveau processus avec les conventions suivantes :

Le nom du programme est NomProgramme.
Les paramètres au programme sont Parametres.
Les attributs de sécurité du processus sont AttributsProcessus.
Les attributs de sécurité du thread dans le processus sont AttribustThread.
Le processus fils hérite des handles héritables du processus courant si Heritage vaut Vrai.
Les options de lancement Options valent généralement CREATE_DEFAULT_ERROR_MODE|NORMAL_PRIORITY_CLASS.
Les variables environnement Environnement sont généralement les mêmes que celles du processus courant.
Le répertoire initial du processus fils sera RepertoireInitial.
Les informations de démarrage d'interaction sont InformationsDemarrage.
Les informations de démarrage du processus sont InformationsProcessus.

Le résultat est non nul si le processus a pu être créé.

Exemple


#include <windows.h>

#include <winbase.h>



char Programme[100];

char Parametres[100];

char RepertoireInitial[100];

STARTUPINFO InformationDemarrage;

PROCESS_INFORMATION InformationProcessus;



...

InformationDemarrage.cb=sizeof(STARTUPINFOW);

InformationDemarrage.lpReserved=NULL;
 
InformationDemarrage.lpDesktop=NULL;

InformationDemarrage.lpTitle=NULL;

InformationDemarrage.dwX=0;
 
InformationDemarrage.dwY=0;
 
InformationDemarrage.dwXSize=0;
 
InformationDemarrage.dwYSize=0;

InformationDemarrage.dwXCountChars=0;

InformationDemarrage.dwYCountChars=0;
 
InformationDemarrage.dwFillAttribute=0;

InformationDemarrage.wShowWindow=SW_SHOW;

InformationDemarrage.cbReserved2=0;
 
InformationDemarrage.lpReserved2=0;
 
InformationDemarrage.hStdInput=GetStdHandle(STD_INPUT_HANDLE);

InformationDemarrage.hStdOutput=GetStdHandle(STD_OUTPUT_HANDLE);

InformationDemarrage.hStdError=GetStdHandle(STD_ERROR_HANDLE);

InformationDemarrage.dwFlags=STARTF_USESHOWWINDOW|STARTF_USESTDHANDLES;

InformationProcessus.hProcess=NULL;
 
InformationProcessus.hThread=NULL;

InformationProcessus.dwProcessId=0;
 
InformationProcessus.dwThreadId=0;

if (!CreateProcess((LPCSTR)Programme, (LPCSTR)Parametres, NULL, NULL, TRUE, CREATE_DEFAULT_ERROR_MODE|NORMAL_PRIORITY_CLASS, NULL, (LPCSTR)RepertoireInitial, &InformationDemarrage, &InformationProcessus))

   {

   ...

   }

...

if (!TerminateProcess(InformationProcessus.hProcess, 0))

   {

   ...

   }

...

Avertissement

Le séparateur de répertoire doit être le caractère division inversée \.

Si le chemin n'est pas précisé, le programme est cherché dans le répertoire courant du processus, sinon dans la liste des chemins donné par la variable environnement PATH.

Voir aussi

TerminateProcess pour terminer un processus. GetExitCodeProcess pour lire le code retour du processus créé.

CreateThread pour créer un nouveau thread.