fonction TSPI_phoneSetButtonInfo (tspi.h)

Article
03/06/2024

La fonction TSPI_phoneSetButtonInfo définit des informations sur le bouton spécifié sur le téléphone spécifié.

Syntaxe

LONG TSPIAPI TSPI_phoneSetButtonInfo(
  DRV_REQUESTID           dwRequestID,
  HDRVPHONE               hdPhone,
  DWORD                   dwButtonLampID,
  LPPHONEBUTTONINFO const lpButtonInfo
);

Paramètres

dwRequestID

Identificateur de la requête asynchrone. Le fournisseur de services retourne cette valeur si la fonction se termine de manière asynchrone.

hdPhone

Handle du téléphone pour lequel les informations de bouton doivent être définies.

dwButtonLampID

Bouton sur l’appareil téléphonique.

lpButtonInfo

Pointeur vers une structure de taille variable de type PHONEBUTTONINFO. Cette structure de données décrit le mode et la fonction, et fournit du texte descriptif supplémentaire à définir pour le bouton.

Valeur retournée

Retourne la valeur (positive) dwRequestID si la fonction est terminée de manière asynchrone, ou un numéro d’erreur si une erreur se produit. Le paramètre réel lResult du ASYNC_COMPLETION correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

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