fonction phoneSetStatusMessages (tapi.h)

Article
08/26/2023

La fonction phoneSetStatusMessages permet à une application de surveiller l’appareil téléphonique spécifié pour les événements status sélectionnés.

Syntaxe

LONG phoneSetStatusMessages(
  HPHONE hPhone,
  DWORD  dwPhoneStates,
  DWORD  dwButtonModes,
  DWORD  dwButtonStates
);

Paramètres

hPhone

Gérez l’appareil téléphonique ouvert à surveiller.

dwPhoneStates

Ensemble de modifications et d’événements de status téléphone pour lesquels l’application peut recevoir des messages de notification. Ce paramètre peut avoir zéro, une ou plusieurs constantes PHONESTATE_.

dwButtonModes

Ensemble de modes de bouton téléphonique pour lesquels l’application peut recevoir des messages de notification. Ce paramètre peut avoir zéro, une ou plusieurs constantes PHONEBUTTONMODE_.

dwButtonStates

Ensemble de modifications d’état de bouton téléphonique pour lesquelles l’application peut recevoir des messages de notification. Si le paramètre dwButtonModes est égal à zéro, dwButtonStates est ignoré. Si dwButtonModes a un ou plusieurs bits définis, ce paramètre doit également avoir au moins un bit défini. Ce paramètre utilise les constantes PHONEBUTTONSTATE_.

Valeur retournée

Retourne zéro si la demande réussit ou un nombre d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALBUTTONMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONSTATE, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Remarques

Une application peut utiliser la fonction phoneSetStatusMessages pour activer ou désactiver la génération des messages correspondants. Tous les messages status téléphoniques sont désactivés par défaut.