IDebugClient5 ::SetEventCallbacksWide, méthode (dbgeng.h)

Article
02/06/2025

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

Syntaxe

HRESULT SetEventCallbacksWide(
  [in] PDEBUG_EVENT_CALLBACKS_WIDE Callbacks
);

Paramètres

[in] Callbacks

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

Valeur de retour

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.

Retourner le code	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 plus un objet IDebugEventCallbacks ou objet IDebugEventCallbacksWide inscrit auprès de celui-ci pour recevoir des événements .

L’interface IDebugEventCallbacksWide é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 SetEventCallbacks ou SetEventCallbacksWide est appelée sur ce client, ou lorsque ce client est supprimé.

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