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 |