phoneGetLamp-Funktion (tapi.h)

Die phoneGetLamp-Funktion gibt den aktuellen Lampenmodus der angegebenen Lampe zurück.

Syntax

LONG phoneGetLamp(
  HPHONE  hPhone,
  DWORD   dwButtonLampID,
  LPDWORD lpdwLampMode
);

Parameter

hPhone

Handle zum geöffneten Telefongerät.

dwButtonLampID

Bezeichner der abzufragten Lampe.

lpdwLampMode

Zeiger auf eine Speicherposition, die den Lampenmodus status der angegebenen Lampe enthält. Dieser Parameter verwendet nur eine der PHONELAMPMODE_ Konstanten.

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALBUTTONLAMPID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Hinweise

Telefonsets, die mehrere Lampen pro Taste haben, sollten mit mehreren Tasten-/Lampenpaaren modelliert werden. Jedes zusätzliche Tasten-/Lampenpaar sollte eine DUMMY-Taste verwenden.

Anforderungen

Weitere Informationen

Ergänzende Telefondienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz