TSPI_phoneGetDisplay-Funktion (tspi.h)
Die TSPI_phoneGetDisplay-Funktion gibt den aktuellen Inhalt der angegebenen Telefonanzeige zurück.
Syntax
LONG TSPIAPI TSPI_phoneGetDisplay(
HDRVPHONE hdPhone,
LPVARSTRING lpDisplay
);
Parameter
hdPhone
Das Ziehpunkt für das abzufragte Telefon.
lpDisplay
Ein Zeiger auf den Speicherort, an dem der Anzeigeinhalt vom Anbieter vom Typ VARSTRING gespeichert werden soll. Vor dem Aufrufen TSPI_phoneGetDisplay legt die Anwendung den dwTotalSize-Member dieser Struktur fest, um die Menge an Arbeitsspeicher anzugeben, die TAPI für die Rückgabe 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:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Hinweise
Der lpDisplay-Speicherbereich sollte mindestens dwDisplayNumRows * dwDisplayNumColumns-Elemente groß sein, um alle Anzeigeinformationen zu empfangen. Die Elemente dwDisplayNumRows und dwDisplayNumColumns sind in der PHONECAPS-Struktur verfügbar, die von TSPI_phoneGetDevCaps zurückgegeben wird.
Der Dienstanbieter füllt alle Member der VARSTRING-Datenstruktur aus, mit Ausnahme von dwTotalSize, das von TAPI ausgefüllt wird. Der Dienstanbieter darf den dwTotalSize-Member nicht überschreiben.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |