Partager via


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

Voir aussi

PHONESTATUS

Fonctions de service téléphonique supplémentaires

Vue d’ensemble de la référence TAPI 2.2