phoneSetStatusMessages-Funktion (tapi.h)
Mit der Funktion phoneSetStatusMessages kann eine Anwendung das angegebene Telefongerät auf ausgewählte status Ereignisse überwachen.
Syntax
LONG phoneSetStatusMessages(
HPHONE hPhone,
DWORD dwPhoneStates,
DWORD dwButtonModes,
DWORD dwButtonStates
);
Parameter
hPhone
Behandeln Des geöffneten Telefongeräts, das überwacht werden soll.
dwPhoneStates
Eine Reihe von Telefon-status Änderungen und Ereignisse, für die die Anwendung Benachrichtigungsnachrichten empfangen kann. Dieser Parameter kann null, eine oder mehrere der PHONESTATE_ Konstanten aufweisen.
dwButtonModes
Eine Reihe von Telefonschaltflächenmodi, für die die Anwendung Benachrichtigungsnachrichten empfangen kann. Dieser Parameter kann null, eine oder mehrere der PHONEBUTTONMODE_ Konstanten aufweisen.
dwButtonStates
Eine Reihe von Telefonschaltflächenstatusänderungen, für die die Anwendung Benachrichtigungsnachrichten empfangen kann. Wenn der dwButtonModes-Parameter 0 ist, wird dwButtonStates ignoriert. Wenn für dwButtonModes mindestens ein Bit festgelegt ist, muss auch für diesen Parameter mindestens ein Bit festgelegt sein. Dieser Parameter verwendet die 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_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALBUTTONMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONSTATE, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.
Hinweise
Eine Anwendung kann die funktion phoneSetStatusMessages verwenden, um die Generierung der entsprechenden Nachrichten zu aktivieren oder zu deaktivieren. Alle Telefon-status-Nachrichten sind standardmäßig deaktiviert.
Anforderungen
Zielplattform | Windows |
Kopfzeile | tapi.h |
Bibliothek | Tapi32.lib |
DLL | Tapi32.dll |
Weitere Informationen
Zusätzliche Telefondienstfunktionen