TSPI_lineGetID函式 (tspi.h)
TSPI_lineGetID函式會針對與選取的行、位址或呼叫相關聯的指定裝置類別，傳回裝置標識符。
語法
LONG TSPIAPI TSPI_lineGetID(
HDRVLINE hdLine,
DWORD dwAddressID,
HDRVCALL hdCall,
DWORD dwSelect,
LPVARSTRING lpDeviceID,
LPCWSTR lpszDeviceClass,
HANDLE hTargetProcess
);
參數
hdLine
要查詢之行的服務提供者句柄。
dwAddressID
指定開啟行裝置上的位址。 位址標識符永久與地址相關聯;標識碼在操作系統升級之間維持不變。 呼叫此函式時，TAPI 不會驗證此參數。
hdCall
要查詢之呼叫的服務提供者句柄。
dwSelect
指定所要求的裝置標識碼是否與行、位址或單一呼叫相關聯。 dwSelect 參數只能有其中一個LINECALLSELECT_常數。
lpDeviceID
VARSTRING 類型的記憶體位置指標，其中會傳回裝置標識碼。 成功完成要求時，此位置會填入裝置標識碼。 傳回資訊的格式取決於裝置類別所使用的方法， (API) 來命名裝置。
lpszDeviceClass
Null 終止 Unicode 字串的指標，指定要求標識碼之裝置的裝置類別。 有效的裝置類別字串是在 [System.ini] 區段中用來識別裝置類別 (，例如 COM、Wave 和 MCI.)
hTargetProcess
叫用 TSPI_lineGetID 函式的應用程式進程句柄。 如果 VARSTRING 結構中傳回的資訊包含供應用程式使用的句柄，服務提供者應該建立或複製進程的句柄。
如果 hTargetProcess 設定為 INVALID_HANDLE_VALUE，則應用程式會在遠端客戶端系統上執行，而且無法直接建立重複的句柄。 相反地， VARSTRING 結構應該包含網路裝置的 UNC 名稱，或是遠端用戶端可用來存取裝置的其他名稱。 如果無法這樣做，則函式應該會失敗。
傳回值
如果函式成功，則傳回零，如果發生錯誤，則傳回錯誤號碼。 可能的傳回值如下所示：
LINEERR_INVALLINEHANDLE、LINEERR_NOMEM、LINEERR_INVALADDRESSID、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NODEVICE LINEERR_RESOURCEUNAVAIL。
備註
如果 dwSelect 是LINECALLSELECT_LINE或LINECALLSELECT_ADDRESS，且 hdLine 無效，則服務會傳回LINEERR_INVALLINEHANDLE。
如果 dwSelect 為LINECALLSELECT_CALL且 hdCall 無效，服務提供者會傳回LINEERR_INVALCALLHANDLE。
服務提供者應該支援 tapi/line 裝置類別，以允許應用程式判斷開啟行的實際行裝置識別碼。 在此情況下，傳回的變數數據是 dwDeviceID。 如需常見裝置類別名稱的詳細資訊，請參閱 TSPI 裝置類別。
定義裝置特定媒體類型的廠商也需要定義對應的裝置特定 (專屬) API 來管理媒體類型的裝置。 為了避免不同廠商獨立指派的裝置類別名稱發生衝突，廠商應該選取可唯一識別廠商的名稱，然後選取媒體類型;例如：「intel/video」。
服務提供者會填入 VARSTRING 數據結構的所有成員，但 dwTotalSize 除外，而 DWTotalSize 則由 TAPI 填入。 服務提供者不得覆寫 dwTotalSize 成員。
服務提供者不需要擔心處理 tapi/line 和 tapi/phone 裝置類別，因為 TAPI 會處理服務提供者的這些類別。 因此，處理這些裝置類別的程式代碼是選擇性的。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tspi.h |