lineGetAgentStatusA 函式 (tapi.h)
lineGetAgentStatus 函式會取得指定位址上的代理程序相關狀態。
語法
LONG lineGetAgentStatusA(
HLINE hLine,
DWORD dwAddressID,
LPLINEAGENTSTATUS lpAgentStatus
);
參數
hLine
開啟行裝置的句柄。
dwAddressID
要查詢其代理程式狀態的開啟行裝置上的位址。 位址標識符永久與地址相關聯;標識碼在操作系統升級之間維持不變。
lpAgentStatus
LINEAGENTSTATUS 類型的可變大小結構的指標。 成功完成要求時，此結構會填入代理程式狀態資訊。 在呼叫 lineGetAgentStatus之前，應用程式必須設定這個結構的 dwTotalSize 成員，以指出TAPI可用來傳回資訊的記憶體數量。
注意 如果結構中的 size 參數不正確，可能會覆寫記憶體。 如需設定結構大小的詳細資訊，請參閱 記憶體配置 主題。
傳回值
如果異步操作啟動，則傳回正要求標識符;否則，下列其中一個負誤差值：
LINEERR_INVALADDRESSID、LINEERR_INVALLINEHANDLE、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_STRUCTURETOOSMALL、LINEERR_UNINITIALIZED。
備註
注意
tapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 lineGetAgentStatus 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |