Méthode IDebugClient5 ::CreateProcess2 (dbgeng.h)

Article
02/26/2024

La méthode CreateProcess2 exécute la commande donnée pour créer un processus.

Syntaxe

HRESULT CreateProcess2(
  [in]           ULONG64 Server,
  [in]           PSTR    CommandLine,
  [in]           PVOID   OptionsBuffer,
  [in]           ULONG   OptionsBufferSize,
  [in, optional] PCSTR   InitialDirectory,
  [in, optional] PCSTR   Environment
);

Paramètres

[in] Server

Spécifie le serveur de processus qui sera attaché au processus. Si Le serveur est égal à zéro, le moteur crée le processus local sans utiliser de serveur de processus.

[in] CommandLine

Spécifie la ligne de commande à exécuter pour créer le nouveau processus.

[in] OptionsBuffer

Spécifie les options de création de processus. OptionsBuffer est un pointeur vers une structure DEBUG_CREATE_PROCESS_OPTIONS .

[in] OptionsBufferSize

Spécifie la taille de la mémoire tampon OptionsBuffer. Cette valeur doit être définie sur sizeof(DEBUG_CREATE_PROCESS_OPTIONS).

[in, optional] InitialDirectory

Spécifie le répertoire de départ du processus. Si InitialDirectory a la valeur NULL, le répertoire actif du serveur de processus est utilisé.

[in, optional] Environment

Spécifie un bloc d’environnement pour le nouveau processus. Un bloc d’environnement se compose d’un bloc de chaînes terminées par null. Chaque chaîne se présente sous la forme suivante :

name=value

Notez que les deux derniers caractères du bloc d’environnement sont à la fois NULL : l’un pour arrêter la chaîne et l’autre pour terminer le bloc.

Si Environnement a la valeur NULL, le nouveau processus hérite du bloc d’environnement du serveur de processus. Si l’indicateur DEBUG_CREATE_PROCESS_THROUGH_RTL est défini dans OptionsBuffer, l’environnement doit avoir la valeur NULL.

Valeur retournée

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Code de retour	Description
S_OK	La méthode a réussi.

Remarques

Cette méthode est disponible uniquement pour le débogage en mode utilisateur actif.

Si CreateFlags contient l’un des indicateurs DEBUG_PROCESS ou DEBUG_ONLY_THIS_PROCESS, le moteur s’attache également au processus nouvellement créé. Cela est similaire au comportement de CreateProcessAndAttach2 avec son argument ProcessId défini sur zéro.

Pour plus d’informations sur la création et l’attachement à des cibles en mode utilisateur dynamiques, consultez Cibles de User-Mode en direct.