funzione phoneSetData (tapi.h)
La funzione phoneSetData scarica le informazioni nel buffer specificato nel dispositivo telefono aperto all'identificatore di dati selezionato.
Sintassi
LONG phoneSetData(
HPHONE hPhone,
DWORD dwDataID,
LPVOID const lpData,
DWORD dwSize
);
Parametri
hPhone
Gestire il dispositivo telefono aperto. L'applicazione deve essere il proprietario del telefono.
dwDataID
Dove nel dispositivo telefonico il buffer deve essere scaricato.
lpData
Puntatore al percorso di memoria da cui scaricare i dati.
dwSize
Dimensioni del buffer, in byte.
Valore restituito
Restituisce un identificatore di richiesta positivo se la funzione viene completata in modo asincrono o un numero di errore negativo se si verifica un errore. Il parametro dwParam2 del messaggio di PHONE_REPLY corrispondente è zero se la funzione ha esito positivo o è un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALDATAID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED.
Commenti
La funzione phoneSetData scarica un massimo di byte dwSize da lpData al dispositivo telefonico. Il formato dei dati, il relativo significato per il dispositivo telefonico e il significato dell'identificatore di dati sono specifici del provider di servizi. I dati nel buffer o la selezione di un identificatore di dati possono fungere da comandi per il dispositivo telefonico.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |