fonction phoneGetStatusMessages (tapi.h)

Article
03/02/2024

La fonction phoneGetStatusMessages retourne les modifications d’état du téléphone sur l’appareil téléphonique spécifié qui génèrent un rappel à l’application.

Syntaxe

LONG phoneGetStatusMessages(
  HPHONE  hPhone,
  LPDWORD lpdwPhoneStates,
  LPDWORD lpdwButtonModes,
  LPDWORD lpdwButtonStates
);

Paramètres

hPhone

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

lpdwPhoneStates

Pointeur vers un DWORD contenant zéro, une ou plusieurs constantes PHONESTATE_. Ces indicateurs spécifient l’ensemble des modifications et événements de status téléphoniques pour lesquels l’application peut recevoir des messages de notification. La supervision peut être activée et désactivée individuellement.

lpdwButtonModes

Pointeur vers un DWORD contenant des indicateurs qui spécifient l’ensemble des modes de bouton téléphonique pour lesquels l’application peut recevoir des messages de notification. Ce paramètre utilise zéro, une ou plusieurs constantes PHONEBUTTONMODE_.

lpdwButtonStates

Pointeur vers un DWORD qui contient des indicateurs spécifiant l’ensemble des modifications d’état du bouton de téléphone pour lesquelles l’application peut recevoir des messages de notification. Ce paramètre utilise zéro, une ou plusieurs constantes PHONEBUTTONSTATE_.

Valeur retournée

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONFAILED, PHONEERR_UNINITIALIZED.

Remarques

Une application peut utiliser phoneGetStatusMessages pour interroger la génération des messages correspondants. La génération de messages peut être contrôlée par phoneGetStatusMessages. Tous les messages status téléphone sont désactivés par défaut.