TSPI_lineGetAddressStatus函式 (tspi.h)
TSPI_lineGetAddressStatus函式會查詢指定位址的目前狀態。
語法
LONG TSPIAPI TSPI_lineGetAddressStatus(
HDRVLINE hdLine,
DWORD dwAddressID,
LPLINEADDRESSSTATUS lpAddressStatus
);
參數
hdLine
服務提供者的句柄，該行包含要查詢的位址。
dwAddressID
指定開啟行裝置上的位址。 這是要查詢的位址。 位址標識符會永久與地址相關聯;標識碼在操作系統升級期間會維持不變。 呼叫此函式時，TAPI 不會驗證此參數。
lpAddressStatus
LINEADDRESSSTATUS 類型的可變大小數據結構的指標。
傳回值
如果函式成功，則傳回零;如果發生錯誤，則傳回錯誤號碼。 可能的傳回值如下所示：
LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESSID、LINEERR_OPERATIONFAILED、LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL。
備註
服務提供者會填入 LINEADDRESSSTATUS 數據結構的所有成員，但由 TAPI 填入 的 dwTotalSize 除外。 服務提供者不得覆寫 dwTotalSize 成員。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tspi.h |