phoneSetLamp-Funktion (tapi.h)

Die phoneSetLamp-Funktion bewirkt, dass die angegebene Lampe auf dem angegebenen geöffneten Telefongerät im angegebenen Lampenmodus leuchtet.

Syntax

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

Parameter

hPhone

Handle zum geöffneten Telefongerät. Die Anwendung muss der Besitzer des Telefons sein.

dwButtonLampID

Knopf, dessen Lampe beleuchtet werden soll.

dwLampMode

Wie die Lampe angezündet werden soll. Dieser Parameter verwendet nur eine der PHONELAMPMODE_ Konstanten.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden PHONE_REPLY Meldung ist null, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALBUTTONLAMPID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALLAMPMODE, PHONEERR_UNINITIALIZED.

Anforderungen

Weitere Informationen

PHONE_REPLY

Ergänzende Telefondienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz