phoneGetData-Funktion (tapi.h)

Die phoneGetData-Funktion lädt die Informationen vom angegebenen Speicherort auf dem geöffneten Telefongerät in den angegebenen Puffer hoch.

Syntax

LONG phoneGetData(
  HPHONE hPhone,
  DWORD  dwDataID,
  LPVOID lpData,
  DWORD  dwSize
);

Parameter

hPhone

Handle zum geöffneten Telefongerät.

dwDataID

Wo auf dem Telefongerät der Puffer hochgeladen werden soll.

lpData

Zeiger auf den Speicherpuffer, in den die Daten hochgeladen werden sollen.

dwSize

Größe des Datenpuffers in Bytes.

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_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALDATAID, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Hinweise

Die Funktion lädt maximal dwSize-Bytes vom Telefongerät in den Speicherbereich hoch, auf den lpData verweist. Wenn dwSize null ist, wird nichts kopiert. Die Größe der einzelnen Datenbereiche wird in den Gerätefunktionen des Telefons aufgeführt.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	tapi.h
Bibliothek	Tapi32.lib
DLL	Tapi32.dll

Weitere Informationen

Ergänzende Telefondienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz