Función phoneSetData (tapi.h)
La función phoneSetData descarga la información del búfer especificado en el dispositivo telefónico abierto en el identificador de datos seleccionado.
Sintaxis
LONG phoneSetData(
HPHONE hPhone,
DWORD dwDataID,
LPVOID const lpData,
DWORD dwSize
);
Parámetros
hPhone
Controle el dispositivo de teléfono abierto. La aplicación debe ser el propietario del teléfono.
dwDataID
Donde en el dispositivo telefónico se va a descargar el búfer.
lpData
Puntero a la ubicación de memoria desde la que se descargarán los datos.
dwSize
Tamaño del búfer, en bytes.
Valor devuelto
Devuelve un identificador de solicitud positivo si la función se completa de forma asincrónica o un número de error negativo si se produce un error. El parámetro dwParam2 del mensaje de PHONE_REPLY correspondiente es cero si la función se ejecuta correctamente o es un número de error negativo si se produce un error. Los valores devueltos posibles son:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALDATAID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED.
Comentarios
La función phoneSetData descarga un máximo de bytes dwSize de lpData al dispositivo telefónico. El formato de los datos, su significado para el dispositivo telefónico y el significado del identificador de datos son específicos del proveedor de servicios. Los datos del búfer o la selección de un identificador de datos pueden actuar como comandos para el dispositivo telefónico.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |