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 succeeds or a negative error number if an error occurs. 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.

QuickInfo

  Version: Use TAPI version 1.4 and later.
  Header: Declared in tapi.h.
  Import Library: Link with tapi32.lib.

See Also

TAPI Reference Overview, Supplementary Phone Services Functions