使用英语阅读

通过

lineGetIconW 函数 （tapi.h）

  • 项目

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

语法

LONG lineGetIconW(
  DWORD   dwDeviceID,
  LPCWSTR 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 或更高版本的应用程序，TAPI 仅当 lpszDeviceClass 参数为“tapi/line”、“”或 NULL时，TAPI 才会替换默认行图标。 对于任何其他设备类，如果给定的设备类无效或提供程序不支持类的图标，lineGetIcon 返回LINEERR_INVALDEVICECLASS。

备注

tapi.h 标头将 lineGetIcon 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
目标平台 窗户
标头 tapi.h
库 Tapi32.lib
DLL Tapi32.dll

另请参阅

基本电话服务参考

TAPI 2.2 参考概述

lineGetID