phoneGetDisplay-Funktion (tapi.h)

Artikel
08/26/2023

Die phoneGetDisplay-Funktion gibt den aktuellen Inhalt der angegebenen Telefonanzeige zurück.

Syntax

LONG phoneGetDisplay(
  HPHONE      hPhone,
  LPVARSTRING lpDisplay
);

Parameter

hPhone

Handle mit dem geöffneten Telefongerät.

lpDisplay

Zeiger auf den Speicherspeicherort, an dem der Anzeigeinhalt gespeichert werden soll, vom Typ VARSTRING.

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

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 phoneGetDevCaps zurückgegeben wird.