fonction phoneGetStatus (tapi.h)
La fonction phoneGetStatus permet à une application d’interroger l’appareil téléphonique ouvert spécifié pour son status global.
Syntaxe
LONG phoneGetStatus(
HPHONE hPhone,
LPPHONESTATUS lpPhoneStatus
);
Paramètres
hPhone
Gérez l’appareil téléphonique ouvert à interroger.
lpPhoneStatus
Pointeur vers une structure de données de taille variable de type PHONESTATUS, qui est chargée avec les informations retournées sur le status du téléphone.
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_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONFAILED, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.
Remarques
Une application peut utiliser cette fonction pour déterminer l’état actuel d’un appareil téléphonique ouvert. Les informations status décrivent des informations sur les périphériques hookswitch, la sonnerie, le volume, l’affichage et les lampes de l’appareil téléphonique.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tapi.h |
| Bibliothèque | Tapi32.lib |
| DLL | Tapi32.dll |