Partager via


fonction phoneSetButtonInfo (tapi.h)

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

Syntaxe

LONG phoneSetButtonInfo(
  HPHONE                  hPhone,
  DWORD                   dwButtonLampID,
  LPPHONEBUTTONINFO const lpButtonInfo
);

Paramètres

hPhone

Gérez l’appareil téléphonique ouvert. L’application doit être le propriétaire de l’appareil téléphonique.

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, la fonction et fournit un texte descriptif supplémentaire sur le bouton.

Valeur retournée

Retourne un identificateur de requête positif si la fonction est terminée de manière asynchrone ou un numéro d’erreur négatif si une erreur se produit. Le paramètre dwParam2 du message PHONE_REPLY correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONEHANDLE, PHONEERR_STRUCTURETOOSMALL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.

Configuration requise

   
Plateforme cible Windows
En-tête tapi.h
Bibliothèque Tapi32.lib
DLL Tapi32.dll

Voir aussi

PHONEBUTTONINFO

PHONE_REPLY

Fonctions de service téléphonique supplémentaires

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