Méthode IDebugClient3 ::CreateProcessWide (dbgeng.h)

Article
02/23/2024

La méthode CreateProcessWide crée un processus à partir de la ligne de commande spécifiée.

Syntaxe

HRESULT CreateProcessWide(
  [in] ULONG64 Server,
  [in] PWSTR   CommandLine,
  [in] ULONG   CreateFlags
);

Paramètres

[in] Server

Spécifie le serveur de processus à utiliser lors de l’attachement au processus. Si Server est égal à zéro, le moteur crée un processus local sans utiliser de serveur de processus.

[in] CommandLine

Spécifie la ligne de commande à exécuter pour créer le nouveau processus. La méthode CreateProcessWide peut modifier le contenu de la chaîne que vous fournissez dans ce paramètre. Par conséquent, ce paramètre ne peut pas être un pointeur vers la mémoire en lecture seule (par exemple, une variable const ou une chaîne littérale). Le passage d’une chaîne constante dans ce paramètre peut entraîner une violation d’accès.

[in] CreateFlags

Spécifie les indicateurs à utiliser lors de la création du processus. Pour plus d’informations sur ces indicateurs, consultez le membre CreateFlags de la structure DEBUG_CREATE_PROCESS_OPTIONS .

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éé. Ce comportement est similaire à celui de CreateProcessAndAttach2 lorsque son argument ProcessId est 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.