phoneGetButtonInfo-Funktion (tapi.h)

Die phoneGetButtonInfo-Funktion gibt Informationen zur angegebenen Schaltfläche zurück.

Syntax

LONG phoneGetButtonInfo(
  HPHONE            hPhone,
  DWORD             dwButtonLampID,
  LPPHONEBUTTONINFO lpButtonInfo
);

Parameter

hPhone

Handle mit dem geöffneten Telefongerät.

dwButtonLampID

Schaltfläche auf dem Telefongerät.

lpButtonInfo

Zeiger auf eine variabel dimensionierte Struktur vom Typ PHONEBUTTONINFO. Diese Datenstruktur beschreibt den Modus und die Funktion und stellt zusätzlichen beschreibenden Text zur Verfügung, der der Schaltfläche entspricht.

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_INVALBUTTONLAMPID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	tapi.h
Bibliothek	Tapi32.lib
DLL	Tapi32.dll

Weitere Informationen

PHONEBUTTONINFO

Zusätzliche Telefondienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz