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 時，才會取代預設行圖示。 對於任何其他裝置類別，如果指定的裝置類別無效，或提供者不支援類別的圖示， lineGetIcon 會傳回LINEERR_INVALDEVICECLASS。
注意
tapi.h 標頭會將 lineGetIcon 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |