TSPI_phoneGetButtonInfo-Funktion (tspi.h)
Die TSPI_phoneGetButtonInfo-Funktion gibt Informationen zu einer angegebenen Schaltfläche zurück.
Syntax
LONG TSPIAPI TSPI_phoneGetButtonInfo(
HDRVPHONE hdPhone,
DWORD dwButtonLampID,
LPPHONEBUTTONINFO lpButtonInfo
);
Parameter
hdPhone
Der Griff für das abzufragte Telefon.
dwButtonLampID
Eine Schaltfläche auf dem Telefongerät.
lpButtonInfo
Ein Zeiger auf den Arbeitsspeicher, in den der Dienstanbieter eine strukturvariable Größe vom Typ PHONEBUTTONINFO schreibt. Diese Datenstruktur beschreibt den Modus und die Funktion und stellt zusätzlichen beschreibenden Text zur Verfügung, der der Schaltfläche entspricht. Vor dem Aufrufen TSPI_phoneGetButtonInfo legt die Anwendung den dwTotalSize-Member dieser Struktur fest, um die Menge an Arbeitsspeicher anzugeben, die TAPI zum Zurückgeben von Informationen zur Verfügung steht.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NOMEM.
Hinweise
Die TSPI_phoneGetButtonInfo-Funktion gibt den PHONEERR_NOMEM Wert zurück, wenn der Dienstanbieter nicht auf den Speicher zugreifen kann, der die Schaltflächeninformationen enthält.
Der Dienstanbieter füllt alle Elemente der PHONEBUTTONINFO-Datenstruktur aus, mit Ausnahme von dwTotalSize, das von TAPI ausgefüllt wird. Der Dienstanbieter darf den dwTotalSize-Member nicht überschreiben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |