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

Article
02/23/2024

La méthode CreateProcess2Wide exécute la commande spécifiée pour créer un processus.

Syntaxe

HRESULT CreateProcess2Wide(
  [in]           ULONG64 Server,
  [in]           PWSTR   CommandLine,
  [in]           PVOID   OptionsBuffer,
  [in]           ULONG   OptionsBufferSize,
  [in, optional] PCWSTR  InitialDirectory,
  [in, optional] PCWSTR  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 null de chaînes terminées par null. Chaque chaîne est de 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 en direct, consultez Cibles de User-Mode en direct.