lineGetAddressStatus 函式 (tapi.h)
lineGetAddressStatus函式可讓應用程式查詢其目前狀態的指定位址。
語法
LONG lineGetAddressStatus(
HLINE hLine,
DWORD dwAddressID,
LPLINEADDRESSSTATUS lpAddressStatus
);
參數
hLine
開啟行裝置的控制碼。
dwAddressID
指定開啟行裝置上的位址。 這是要查詢的位址。 位址識別碼會永久與位址相關聯;識別碼在作業系統升級期間會維持不變。
lpAddressStatus
LINEADDRESSSTATUS類型的可變大小資料結構的指標。 在呼叫 lineGetAddressStatus之前，應用程式必須設定此結構的 dwTotalSize 成員，以指出 TAPI 可用來傳回信息的記憶體數量。
注意 如果結構中的大小參數不正確，可能會覆寫資料。 如需設定結構大小的詳細資訊，請參閱 記憶體配置 主題。
傳回值
如果要求成功，則傳回零，如果發生錯誤，則傳回負錯誤號碼。 可能的傳回值為：
LINEERR_INVALADDRESSID、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_STRUCTURETOOSMALL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NOMEM、LINEERR_OPERATIONUNAVAIL LINEERR_OPERATIONFAILED。
規格需求
| 目標平臺 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| DLL | Tapi32.dll |