phoneGetStatus-Funktion (tapi.h)

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.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tapi.h
Bibliothek Tapi32.lib
DLL Tapi32.dll

Weitere Informationen

PHONESTATUS

Ergänzende Telefondienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz