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
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |