lineGetIcon 函数 (tapi.h)

lineGetIcon 函数允许应用程序检索特定于设备的服务线 (或特定于提供程序的) 图标，以便向用户显示。

语法

LONG lineGetIcon(
  DWORD   dwDeviceID,
  LPCSTR  lpszDeviceClass,
  LPHICON lphIcon
);

参数

dwDeviceID

请求其图标的行设备的标识符。

lpszDeviceClass

指向标识设备类名称的 以 null 结尾的字符串的指针。 此设备类允许应用程序选择适用于该设备类的特定子图标。 此参数是可选的，可以保留 NULL 或空，在这种情况下，将选择与行设备（而不是指定的媒体流设备）关联的最高级别图标。

lphIcon

指向内存位置的指针，其中返回图标的句柄。

返回值

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

LINEERR_BADDEVICEID、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALDEVICECLASS、LINEERR_UNINITIALIZED、LINEERR_NOMEM、LINEERR_NODEVICE。

注解

lineGetIcon 函数使提供程序将 lphIcon) 中的句柄 (返回到从与指定行关联的 LoadIcon) 获取的图标资源 (。 图标句柄适用于与提供程序关联的资源。 如果应用程序想要在卸载提供程序后引用图标，则必须使用 CopyIcon ，只要应用程序打开行，就不太可能发生这种情况。

lpszDeviceClass 参数允许提供程序根据调用方引用的服务类型返回不同的图标。 允许的字符串与 lineGetID 相同。 例如，如果行支持 Comm API，则传递“COMM”作为 lpszDeviceClass 会导致提供程序返回与服务提供商的 Comm 设备功能专门相关的图标。 参数“tapi/line”、“”或 NULL 可用于请求线路服务的图标。

对于使用低于 2.0 的 API 版本的应用程序，如果提供程序不返回图标 (是因为给定设备类无效还是提供程序不支持图标) ，TAPI 将替换通用电话线路设备图标。 对于使用 API 版本 2.0 或更高版本的应用程序，仅当 lpszDeviceClass 参数为“tapi/line”、“”或 NULL 时，TAPI 才会替换默认行图标。 对于任何其他设备类，如果给定的设备类无效或提供程序不支持类的图标， lineGetIcon 将返回LINEERR_INVALDEVICECLASS。

要求

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

另请参阅

基本电话服务参考

TAPI 2.2 参考概述

lineGetID