TSPI_phoneGetIcon函数 (tspi.h)
TSPI_phoneGetIcon函数检索服务电话设备特定的 (或特定于提供商的) 图标以显示给用户。
语法
LONG TSPIAPI TSPI_phoneGetIcon(
DWORD dwDeviceID,
LPCWSTR lpszDeviceClass,
LPHICON lphIcon
);
参数
dwDeviceID
请求其图标的手机设备。
lpszDeviceClass
指向以 null 结尾的 Unicode 字符串的指针，该字符串标识设备类名称。 此设备类允许调用方选择适用于该设备类的特定子图标。 此参数是可选的，可以保留 NULL 或为空，在这种情况下，将选择与手机设备（而不是指定的媒体流设备）关联的最高级别图标。
lphIcon
指向在其中返回图标句柄的内存位置的指针。
返回值
如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：
PHONEERR_INVALDEVICECLASS、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_RESOURCEUNAVAIL。
注解
TSPI_phoneGetIcon会导致提供程序返回由 lphIcon) 指向的 DWORD 中的句柄 (， (从 获取的图标资源
LoadIcon 函数) 与指定的手机相关联。 图标句柄适用于与提供程序关联的资源。
lpszDeviceClass 参数允许提供程序根据调用方引用的服务类型返回不同的图标。 允许的字符串与 TSPI_phoneGetID相同。 例如，如果电话支持 Comm API，将 comm/datamodem 作为 lpszDeviceClass 传递会导致提供程序返回专门与服务提供商的 Comm 设备功能相关的图标。 有关常见设备类的详细信息，请参阅 TSPI 设备类。
参数“tapi/phone”、“”或 NULL 可用于请求手机设备的图标。 提供商可以选择支持由 lpszDeviceClass 和/或电话号码) 选择的许多图标 (，单个图标 (例如制造商，无论选择的 lpszDeviceClass) 或没有图标，都会为所有 phoneGetIcon 请求返回该图标，在这种情况下，它会将 lphIcon 指向的 DWORD 设置为 NULL。 TAPI 检查提供程序返回的句柄，如果提供程序返回 NULL，TAPI 将替换 TAPI 中作为资源包含的通用电话图标 (通用电话图标) 。
如果服务提供商不支持任何图标，它可能会使此函数无法实现，在这种情况下，TAPI 为应用程序提供通用电话图标。
要求
| 目标平台 | Windows |
| 标头 | tspi.h |