ITTAPIEventNotification ::Event, méthode (tapi3if.h)

Article
03/02/2024

La méthode Event est appelée par TAPI pour déterminer la réponse à une notification d’événement asynchrone. L’application implémente un ensemble d’instructions case qui utilisent TapiEvent pour déterminer le type d’événement signalé, puis appelle IUnknown ::QueryInterface sur pEvent pour obtenir le pointeur d’interface d’événement approprié. Une interface est associée à chaque événement défini par TAPI 3. Les événements spécifiques gérés dépendent des besoins de l’application.

Syntaxe

HRESULT Event(
  [in] TAPI_EVENT TapiEvent,
  [in] IDispatch  *pEvent
);

Paramètres

[in] TapiEvent

TAPI_EVENT indicateur de l’événement.

[in] pEvent

Pointeur vers une interface IDispatch de l’objet associé à cet événement.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	La méthode a réussi.
E_POINTER	Le paramètre pEvent n’est pas un pointeur valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.

Remarques

Vous devez appeler la méthode ITTAPI ::p ut_EventFilter pour définir le masque de filtre d’événements et activer la réception des événements. Si vous n’appelez pas ITTAPI ::p ut_EventFilter, votre application ne recevra aucun événement.