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

Article
02/23/2024

La méthode SetEventCallbacks inscrit un objet de rappel d’événement auprès de ce client.

Syntaxe

HRESULT SetEventCallbacks(
  [in, optional] PDEBUG_EVENT_CALLBACKS Callbacks
);

Paramètres

[in, optional] Callbacks

Spécifie le pointeur d’interface vers l’objet de rappels d’événements à inscrire auprès de ce client.

Valeur retournée

Selon l’implémentation de la méthode IDebugEventCallbacks ::GetInterestMask dans l’objet spécifié par Callbacks, d’autres valeurs peuvent être retournées, comme décrit dans la section Remarques.

Code de retour	Description
S_OK	La méthode a réussi.

Remarques

Si la valeur de Callbacks n’est pas NULL, la méthode IDebugEventCallbacks ::GetInterestMask est appelée. Si la valeur de retour n’est pas S_OK, SetEventCallbacks et SetEventCallbacksWide n’ont aucun effet et retournent cette valeur.

Chaque client peut avoir au maximum un objet IDebugEventCallbacks ou IDebugEventCallbacksWide inscrit avec lui pour recevoir des événements.

L’interface IDebugEventCallbacks étend l’interface COM IUnknown. Lorsque SetEventCallbacks et SetEventCallbacksWide réussissent, ils appellent la méthode IUnknown ::AddRef de l’objet spécifié par Callbacks. La méthode IUnknown ::Release de cet objet sera appelée la prochaine fois que SetEventCallbacks ou SetEventCallbacksWide sera appelé sur ce client, ou lorsque ce client sera supprimé.

Pour plus d’informations sur les rappels, consultez Rappels.