fonction phoneSetLamp (tapi.h)

  • Article

La fonction phoneSetLamp permet d’allumer la lampe spécifiée sur l’appareil téléphonique ouvert spécifié dans le mode de lampe spécifié.

Syntaxe

LONG phoneSetLamp(
  HPHONE hPhone,
  DWORD  dwButtonLampID,
  DWORD  dwLampMode
);

Paramètres

hPhone

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

dwButtonLampID

Bouton dont la lampe doit être allumée.

dwLampMode

Comment la lampe doit être allumée. Ce paramètre utilise une seule des constantes PHONELAMPMODE_.

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_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALBUTTONLAMPID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALLAMPMODE, PHONEERR_UNINITIALIZED.

Configuration requise

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

Voir aussi

PHONE_REPLY

Fonctions de service téléphonique supplémentaires

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