IDebugProgramNode2::Attach_V7

Article
01/12/2024

Remarque

DÉPRÉCIÉ. N’UTILISEZ PAS.

Syntaxe

int Attach_V7 (
   IDebugProgram2       pMDMProgram,
   IDebugEventCallback2 pCallback,
   uint                 dwReason
);

HRESULT Attach_V7 (
   IDebugProgram2*       pMDMProgram,
   IDebugEventCallback2* pCallback,
   DWORD                 dwReason
);

Paramètres

pMDMProgram
[in] Interface IDebugProgram2 qui représente le programme auquel attacher.

pCallback
[in] Interface IDebugEventCallback2 à utiliser pour envoyer des événements de débogage au SDM.

dwReason
[in] Valeur de l’énumération ATTACH_REASON qui spécifie la raison de l’attachement.

Valeur de retour

Une implémentation doit toujours retourner E_NOTIMPL.

Notes

Avertissement

Depuis Visual Studio 2005, cette méthode n’est plus utilisée et doit toujours retourner E_NOTIMPL. Consultez l’interface IDebugProgramNodeAttach2 pour une autre approche si le nœud du programme doit indiquer qu’il ne peut pas être attaché ou si le nœud du programme définit simplement le programme GUID. Sinon, implémentez la méthode Attach .

Avant Visual Studio 2005

Cette méthode doit être implémentée uniquement si le DE s’exécute dans l’espace d’adressage du programme en cours de débogage. Sinon, cette méthode doit retourner S_FALSE.

Lorsque cette méthode est appelée, le DE doit envoyer l’objet d’événement IDebugEngineCreateEvent2 , s’il n’a pas déjà été envoyé pour cette instance de l’interface IDebugEngine2 , ainsi que les objets d’événement IDebugProgramCreateEvent2 et IDebugLoadCompleteEvent2 . L’objet d’événement IDebugEntryPointEvent2 est ensuite envoyé si le dwReason paramètre est ATTACH_REASON_LAUNCH.

Le DE doit appeler la méthode GetProgramId sur l’objet IDebugProgram2 fourni par l’objet d’événement IDebugProgramCreateEvent2 et doit stocker le GUID de ce programme dans les données d’instance de l’objet implémenté par le IDebugProgram2 DE.

Share via