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

Article
02/23/2024

La méthode CreateProcessAndAttach crée un processus à partir d’une ligne de commande spécifiée, puis l’attache à un autre processus en mode utilisateur. Le processus créé est suspendu et ne peut s’exécuter qu’une fois l’attachement terminé. Cela permet une synchronisation approximative lors du débogage des processus client et serveur.

Syntaxe

HRESULT CreateProcessAndAttach(
  [in]           ULONG64 Server,
  [in, optional] PSTR    CommandLine,
  [in]           ULONG   CreateFlags,
  [in]           ULONG   ProcessId,
  [in]           ULONG   AttachFlags
);

Paramètres

[in] Server

Spécifie le serveur de processus à utiliser pour l’attacher au processus. Si Le serveur est égal à zéro, le moteur se connecte au processus local sans utiliser de serveur de processus.

[in, optional] CommandLine

Spécifie la ligne de commande à exécuter pour créer le nouveau processus. Si CommandLine a la valeur NULL, aucun processus n’est créé et ces méthodes s’attachent à un processus existant, comme le fait AttachProcess .

[in] CreateFlags

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

[in] ProcessId

Spécifie l’ID de processus du processus cible auquel le débogueur est attaché. Si ProcessId est égal à zéro, le débogueur s’attache au processus qu’il a créé à partir de CommandLine.

[in] AttachFlags

Spécifie les indicateurs qui contrôlent la façon dont le débogueur s’attache au processus cible. Pour plus d’informations sur ces indicateurs, consultez DEBUG_ATTACH_XXX.

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 CommandLine n’a pas la valeur NULL et Que ProcessId n’est pas égal à zéro, le moteur crée le processus dans un état suspendu. Le moteur reprendra ce processus nouvellement créé une fois qu’il s’est connecté au processus spécifié dans ProcessId.

Note Le moteur ne s’attache pas complètement au processus tant que la méthode WaitForEvent n’a pas été appelée. Ce n’est qu’une fois que le processus a généré un événement (par exemple, l’événement create-process) qu’il devient disponible dans la session du débogueur.

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