phoneGetStatusMessages-Funktion (tapi.h)

Artikel
08/26/2023

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.