phoneSetStatusMessages-Funktion (tapi.h)

Artikel
08/26/2023

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.