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 |