lineGetLineDevStatus 函式 (tapi.h)
lineGetLineDevStatus 函式可讓應用程式查詢指定的開啟行裝置，以取得其目前狀態。
語法
LONG lineGetLineDevStatus(
HLINE hLine,
LPLINEDEVSTATUS lpLineDevStatus
);
參數
hLine
要查詢之開啟行裝置的句柄。
lpLineDevStatus
LINEDEVSTATUS 類型的可變大小數據結構的指標。 成功完成要求時，此結構會填入該行的裝置狀態。 在呼叫 lineGetLineDevStatus之前，應用程式應該設定此結構的 dwTotalSize 成員，以指出TAPI可用來傳回資訊的記憶體數量。
傳回值
如果要求成功，則傳回零，如果發生錯誤，則傳回負錯誤號碼。 可能的傳回值為：
LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NOMEM、LINEERR_UNINITIALIZED、LINEERR_OPERATIONFAILED LINEERR_OPERATIONUNAVAIL。
備註
應用程式會使用 lineGetLineDevStatus 來查詢線路裝置的目前行狀態。 此狀態資訊會全域套用至線路裝置上的所有位址。 使用 lineGetAddressStatus 來判斷某行上特定地址的狀態資訊。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |