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 参考概述