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

Vedi anche

PHONE_REPLY

Funzioni di servizio telefonico supplementari

Panoramica di riferimento su TAPI 2.2