Partager via


IDebugProgramEx2::Attach

Joignez une session à un programme.

Syntaxe

int Attach( 
   IDebugEventCallback2 pCallback,
   uint                 dwReason,
   IDebugSession2       pSession
);

Paramètres

pCallback
[in] Objet IDebugEventCallback2 qui représente la fonction de rappel à laquelle le moteur de débogage attaché envoie des événements.

dwReason
[in] Valeur de l’énumération ATTACH_REASON qui décrit la raison de l’opération d’attachement.

pSession
[in] Valeur qui identifie de façon unique la session qui est attachée au programme.

Valeur de retour

En cas de réussite, retourne S_OK ; sinon, retourne un code d’erreur. Cette méthode doit retourner E_ATTACH_DEBUGGER_ALREADY_ATTACHED si le programme est déjà attaché.

Notes

Le port qui contient le programme peut utiliser la valeur dans pSession le but de déterminer la session qui tente d’attacher le programme. Par exemple, si un port autorise une seule session de débogage à attacher à un processus à la fois, le port peut déterminer si la même session est déjà attachée à d’autres programmes du processus.

Remarque

L’interface transmise pSession doit être traitée uniquement en tant que cookie, valeur qui identifie de manière unique le gestionnaire de débogage de session attaché à ce programme ; aucune des méthodes de l’interface fournie n’est fonctionnelle.

Voir aussi