phoneSetButtonInfo-Funktion (tapi.h)

Artikel
08/26/2023

Die phoneSetButtonInfo-Funktion legt Informationen zur angegebenen Schaltfläche auf dem angegebenen Telefon fest.

Syntax

LONG phoneSetButtonInfo(
  HPHONE                  hPhone,
  DWORD                   dwButtonLampID,
  LPPHONEBUTTONINFO const lpButtonInfo
);

Parameter

hPhone

Handle zum geöffneten Telefongerät. Die Anwendung muss der Besitzer des Telefongeräts sein.

dwButtonLampID

Schaltfläche auf dem Telefongerät.

lpButtonInfo

Zeiger auf eine strukturvariable Größe vom Typ PHONEBUTTONINFO. Diese Datenstruktur beschreibt den Modus, die Funktion und stellt zusätzlichen beschreibenden Text zur Schaltfläche bereit.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden PHONE_REPLY Meldung ist null, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONEHANDLE, PHONEERR_STRUCTURETOOSMALL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.