phoneGetStatus-Funktion (tapi.h)

Artikel
03/02/2024

Die phoneGetStatus-Funktion ermöglicht es einer Anwendung, das angegebene geöffnete Telefongerät nach dessen gesamter status abzufragen.

Syntax

LONG phoneGetStatus(
  HPHONE        hPhone,
  LPPHONESTATUS lpPhoneStatus
);

Parameter

hPhone

Handle für das geöffnete Telefongerät, das abgefragt werden soll.

lpPhoneStatus

Zeiger auf eine datenvariable Größe vom Typ PHONESTATUS, die mit den zurückgegebenen Informationen zum status des Telefons geladen wird.

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_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONFAILED, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Hinweise

Eine Anwendung kann diese Funktion verwenden, um den aktuellen Zustand eines geöffneten Telefongeräts zu bestimmen. Die status Informationen beschreibt Informationen zu den Hookswitch-Geräten, dem Klingeln, der Lautstärke, dem Display und den Lampen des Telefongeräts.