phoneGetStatusMessages-Funktion (tapi.h)
Die phoneGetStatusMessages-Funktion gibt zurück, welche Telefonstatusänderungen auf dem angegebenen Telefongerät einen Rückruf an die Anwendung generieren.
Syntax
LONG phoneGetStatusMessages(
HPHONE hPhone,
LPDWORD lpdwPhoneStates,
LPDWORD lpdwButtonModes,
LPDWORD lpdwButtonStates
);
Parameter
hPhone
Behandeln Des geöffneten Telefongeräts, das überwacht werden soll.
lpdwPhoneStates
Zeiger auf einen DWORD-Wert mit null, einer oder mehreren der PHONESTATE_ Konstanten. Diese Flags geben den Satz von Telefon-status Änderungen und Ereignissen an, für die die Anwendung Benachrichtigungen empfangen kann. Die Überwachung kann einzeln aktiviert und deaktiviert werden.
lpdwButtonModes
Zeiger auf ein DWORD-Element , das Flags enthält, die den Satz von Telefonschaltflächenmodi angeben, für die die Anwendung Benachrichtigungsnachrichten empfangen kann. Dieser Parameter verwendet null, mindestens eine der PHONEBUTTONMODE_ Konstanten.
lpdwButtonStates
Zeiger auf ein DWORD , das Flags enthält, die den Satz von Telefonschaltflächenstatusänderungen angeben, für die die Anwendung Benachrichtigungsnachrichten empfangen kann. Dieser Parameter verwendet null, mindestens eine der PHONEBUTTONSTATE_ 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_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONFAILED, PHONEERR_UNINITIALIZED.
Hinweise
Eine Anwendung kann phoneGetStatusMessages verwenden, um die Generierung der entsprechenden Nachrichten abzufragen. Die Nachrichtengenerierung kann von phoneGetStatusMessages gesteuert werden. Alle Telefon-status-Nachrichten sind standardmäßig deaktiviert.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | tapi.h |
Bibliothek | Tapi32.lib |
DLL | Tapi32.dll |
Weitere Informationen
Zusätzliche Telefondienstfunktionen