TSPI_phoneSetButtonInfo-Funktion (tspi.h)
Die TSPI_phoneSetButtonInfo-Funktion legt Informationen zur angegebenen Schaltfläche auf dem angegebenen Telefon fest.
Syntax
LONG TSPIAPI TSPI_phoneSetButtonInfo(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwButtonLampID,
LPPHONEBUTTONINFO const lpButtonInfo
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung. Der Dienstanbieter gibt diesen Wert zurück, wenn die Funktion asynchron abgeschlossen wird.
hdPhone
Der Griff zum Telefon, für das Schaltflächeninformationen festgelegt werden sollen.
dwButtonLampID
Eine Schaltfläche auf dem Telefongerät.
lpButtonInfo
Ein Zeiger auf eine variabel dimensionierte Struktur vom Typ PHONEBUTTONINFO. Diese Datenstruktur beschreibt den Modus und die Funktion und stellt zusätzlichen beschreibenden Text bereit, der für die Schaltfläche festgelegt werden soll.
Rückgabewert
Gibt den (positiven) dwRequestID-Wert zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine Fehlernummer, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist 0, wenn die Funktion erfolgreich ist, oder es ist eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Hinweise
Diese Funktion legt die Bedeutung und den zugeordneten beschreibenden Text der Schaltflächen eines Smartphones fest.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |