phoneGetData 函数 (tapi.h)

phoneGetData 函数将信息从打开的电话设备中的指定位置上传到指定的缓冲区。

语法

LONG phoneGetData(
  HPHONE hPhone,
  DWORD  dwDataID,
  LPVOID lpData,
  DWORD  dwSize
);

参数

hPhone

打开的手机设备的句柄。

dwDataID

在手机设备中上传缓冲区的位置。

lpData

指向要在其中上传数据的内存缓冲区的指针。

dwSize

数据缓冲区的大小（以字节为单位）。

返回值

如果请求成功，则返回零;如果发生错误，则返回负错误号。 可能的返回值为：

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALDATAID、PHONEERR_UNINITIALIZED、PHONEERR_OPERATIONUNAVAIL。

注解

函数将最多 dwSize 字节从手机设备上传到 lpData 指向的内存区域。 如果 dwSize 为零，则不复制任何内容。 手机的设备功能中列出了每个数据区域的大小。

要求

要求	值
目标平台	Windows
标头	tapi.h
Library	Tapi32.lib
DLL	Tapi32.dll

另请参阅

补充电话服务函数

TAPI 2.2 参考概述