Méthode IDebugClient4 ::SetEventCallbacks (dbgeng.h)
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énement à 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 Notes.
| Code de retour | Description |
|---|---|
|
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 auprès de celui-ci 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | dbgeng.h (inclure Dbgeng.h) |