phoneGetData
The phoneGetData
function uploads the information from the specified location in the open phone
device to the specified buffer.
LONG phoneGetData(
|
HPHONE hPhone, |
|
|
DWORD dwDataID, |
|
|
LPVOID lpData, |
|
|
DWORD dwSize |
|
|
); |
|
Parameters
hPhone
A handle to
the open phone device.
dwDataID
Where in the
phone device the buffer is to be uploaded from.
lpData
A pointer to
the memory buffer where the data is to be uploaded.
dwSize
The size of
the data buffer in bytes.
Return Values
Returns zero
if the request is successful or a negative error number if an error has
occurred. Possible return values are:
PHONEERR_INVALPHONEHANDLE,
PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL,
PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALDATAID,
PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.
Remarks
The function
uploads a maximum of dwSize bytes from the phone device into the memory
area pointed to by lpData. If dwSize is zero, nothing is copied.
The size of each data area is listed in the phone's device capabilities.