IDebugClient3::CreateProcessWide, méthode (dbgeng.h)

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 le serveur 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 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 de retour

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

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 est également attaché 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 actives en mode utilisateur, consultez Cibles en direct User-Mode.

Configuration requise

   
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (include Dbgeng.h)

Voir aussi

.create (Créer un processus)

AttachProcess

ConnectProcessServer

CreateProcess2

CreateProcessAndAttach2

IDebugClient3

IDebugClient4

IDebugClient5