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。
備註
提供者應該將lphIc) on所指向之 DWORD中的控制碼 (傳回至從 取得的圖示資源 (
LoadIcon 函式) 與指定的行相關聯。
提供者可以選擇支援許多圖示 (由lpszDeviceClass和/或行號) 所選取，單一圖示 (例如製造商，不論選取的lpszDeviceClass) 或沒有圖示，都會針對所有TSPI_lineGetIcon要求傳回此圖示，在此情況下，它會將lphIcon指向的DWORD設定為Null。 TAPI 會檢查提供者傳回的控制碼，如果提供者傳回 Null，TAPI 會取代泛型電話語音圖示， (泛型「行」圖示) 。
需求
| 目標平台 | Windows |
| 標頭 | tspi.h |