phoneSetData-Funktion (tapi.h)

Die phoneSetData-Funktion lädt die Informationen im angegebenen Puffer am ausgewählten Datenbezeichner auf das geöffnete Telefongerät herunter.

Syntax

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

Parameter

hPhone

Handle zum geöffneten Telefongerät. Die Anwendung muss der Besitzer des Telefons sein.

dwDataID

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

lpData

Zeiger auf den Speicherort, von dem die Daten heruntergeladen werden sollen.

dwSize

Größe des Puffers in Bytes.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden PHONE_REPLY Meldung ist null, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALDATAID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED.

Hinweise

Die phoneSetData-Funktion lädt maximal dwSize-Bytes von lpData auf das Telefongerät herunter. Das Format der Daten, ihre Bedeutung für das Telefongerät und die Bedeutung des Datenbezeichners sind dienstanbieterspezifisch. Die Daten im Puffer oder die Auswahl eines Datenbezeichners können als Befehle für das Telefongerät fungieren.

Anforderungen

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

Weitere Informationen

PHONE_REPLY

Ergänzende Telefondienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz