fonction TSPI_phoneGetButtonInfo (tspi.h)

La fonction TSPI_phoneGetButtonInfo retourne des informations sur un bouton spécifié.

Syntaxe

LONG TSPIAPI TSPI_phoneGetButtonInfo(
  HDRVPHONE         hdPhone,
  DWORD             dwButtonLampID,
  LPPHONEBUTTONINFO lpButtonInfo
);

Paramètres

hdPhone

La poignée du téléphone à interroger.

dwButtonLampID

Bouton sur l’appareil téléphonique.

lpButtonInfo

Pointeur vers la mémoire dans lequel le fournisseur de services écrit une structure de taille variable de type PHONEBUTTONINFO. Cette structure de données décrit le mode et la fonction, et fournit un texte descriptif supplémentaire correspondant au bouton. Avant d’appeler TSPI_phoneGetButtonInfo, l’application définit le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible pour TAPI pour retourner des informations.

Valeur retournée

Retourne zéro si la fonction réussit, ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NOMEM.

Remarques

La fonction TSPI_phoneGetButtonInfo retourne la valeur PHONEERR_NOMEM si le fournisseur de services ne peut pas accéder à la mémoire contenant les informations du bouton.

Le fournisseur de services remplit tous les membres de la structure de données PHONEBUTTONINFO , à l’exception de dwTotalSize, qui est renseigné par TAPI. Le fournisseur de services ne doit pas remplacer le membre dwTotalSize .

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	tspi.h

Voir aussi

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneSetButtonInfo