UDF > WinAPIEx > Processes & Synchronization > Processes >


_WinAPI_CreateProcessWithToken

Crée un nouveau processus et son thread principal dans le contexte de sécurité du jeton spécifié

#include <WinAPIProc.au3>
_WinAPI_CreateProcessWithToken ( $sApp, $sCmd, $iFlags, $tStartupInfo, $tProcessInfo, $hToken [, $iLogon = 0 [, $pEnvironment = 0 [, $sDir = '']]] )

Paramètres

$sApp Le nom du module à exécuter. Si ce paramètre est la chaîne vide, le nom du module doit être le premier jeton délimité par un espace blanc dans la chaîne de ligne de commande.
$sCmd La ligne de commande à exécuter. Si ce paramètre est la chaîne vide, la fonction utilise le nom du module comme ligne de commande.
$iFlags Les flags qui contrôlent la façon dont le processus est créé.
Les flags $CREATE_DEFAULT_ERROR_MODE, $CREATE_NEW_CONSOLE, et $CREATE_NEW_PROCESS_GROUP sont activés par défaut.
Vous pouvez spécifier les options supplémentaires suivantes:
    $CREATE_DEFAULT_ERROR_MODE
    $CREATE_NEW_CONSOLE
    $CREATE_NEW_PROCESS_GROUP
    $CREATE_SEPARATE_WOW_VDM
    $CREATE_SUSPENDED
    $CREATE_UNICODE_ENVIRONMENT
$tStartupInfo Une structure $tagSTARTUPINFO ou un pointeur sur une telle structure.
$tProcessInfo Une structure $tagPROCESS_INFORMATION ou un pointeur sur une telle structure qui reçoit des informations sur le nouveau processus, y compris le handle du processus.
$hToken Le handle du jeton primaire qui représente un utilisateur. Le handle doit avoir les droits d'accès $TOKEN_QUERY, $TOKEN_DUPLICATE, et TOKEN_ASSIGN_PRIMARY.
$iLogon [optionnel] L'option d'ouverture de session. Ce paramètre peut être égal à zéro ou à l'une des valeurs suivantes:
    $LOGON_WITH_PROFILE
    $LOGON_NETCREDENTIALS_ONLY
$pEnvironment [optionnel] Un pointeur sur un bloc d'environnement du nouveau processus.
$sDir [optionnel] Le chemin du répertoire courant du processus.
Si ce paramètre est la chaîne vide (par défaut), le nouveau processus aura le même lecteur et le même répertoire que le processus appelant.

Valeur de retour

Succès: Retourne True
Échec: Retourne False

Remarques

Pour obtenir un jeton de sécurité, passez le handle du processus dans la structure $tagPROCESS_INFORMATION pour la fonction _WinAPI_OpenProcessToken().

Cette fonction nécessite Windows Vista ou une version ultérieure.

En relation

_WinAPI_OpenProcessToken

Voir aussi

Consultez CreateProcessWithTokenW dans la librairie MSDN.