TSPI_lineGetIcon 函数 (tspi.h)
TSPI_lineGetIcon 函数检索特定于设备的服务线图标，以便向用户显示。
语法
LONG TSPIAPI TSPI_lineGetIcon(
DWORD dwDeviceID,
LPCWSTR lpszDeviceClass,
LPHICON lphIcon
);
参数
dwDeviceID
请求其图标的行设备。
lpszDeviceClass
指向标识设备类名称的 以 null 结尾的 Unicode 字符串的指针。 此设备类允许调用方选择特定于该设备类的图标。 此参数是可选的，可以保留 NULL，在这种情况下，选择与线路设备（而不是指定的媒体流设备）关联的最高级别图标。
允许的字符串与 TSPI_lineGetID相同。 例如，如果行支持 Comm API，则传递 comm/datamodem 作为 lpszDeviceClass 会导致提供程序返回与服务提供商的 Comm 设备功能相关的图标。
lphIcon
指向内存位置的指针，其中返回图标的句柄。
返回值
如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：
LINEERR_INVALDEVICECLASS、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL、LINEERR_OPERATIONUNAVAIL。
注解
提供程序应将 lphIcon 指向的 DWORD 中的句柄 () 返回到从 获取的图标资源 (
与指定行关联的 LoadIcon 函数) 。
提供程序可以选择支持由 lpszDeviceClass 和/或行号) 选择的许多图标 (，单个图标 (例如制造商，无论选择的 lpszDeviceClass) ，都将为所有TSPI_lineGetIcon请求返回，或者没有图标，在这种情况下，它会将 lphIcon 指向的 DWORD 设置为 NULL。 TAPI 检查提供程序返回的句柄，如果提供程序返回 NULL，TAPI 将替换泛型电话图标 (泛型“行”图标) 。
要求
| 目标平台 | Windows |
| 标头 | tspi.h |