phoneSetButtonInfo-Funktion (tapi.h)
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.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |