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