fonction phoneSetStatusMessages (tapi.h)
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.
Configuration requise
Plateforme cible | Windows |
En-tête | tapi.h |
Bibliothèque | Tapi32.lib |
DLL | Tapi32.dll |
Voir aussi
Fonctions de service téléphonique supplémentaires
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour