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 |