phoneSetData
The phoneSetData
function downloads the information in the specified buffer to the opened phone
device at the selected data ID.
LONG phoneSetData(
|
HPHONE hPhone, |
|
|
DWORD dwDataID, |
|
|
LPVOID
const lpData, |
|
|
DWORD dwSize |
|
|
); |
|
Parameters
hPhone
A handle to
the open phone device. The application must be the owner of the phone.
dwDataID
Where in the
phone device the buffer is to be downloaded.
lpData
A pointer to
the memory location where the data is to be downloaded from.
dwSize
The size of the
buffer in bytes.
Return Values
Returns a
positive request ID if the function will be completed asynchronously or a
negative error number if an error has occurred. The dwParam2 parameter
of the corresponding PHONE_REPLY
message is zero if the function is successful or it is a negative error number
if an error has occurred. Possible return values are:
PHONEERR_INVALPHONEHANDLE,
PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM,
PHONEERR_INVALDATAID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE,
PHONEERR_OPERATIONFAILED, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED.
Remarks
The phoneSetData
function downloads a maximum of dwSize bytes from lpData to the
phone device. The format of the data, its meaning to the phone device, and the
meaning of the data ID are service-provider specific. The data in the buffer or
the selection of a data ID may act as commands to the phone device.
See Also