共用方式為

lineGetAgentStatusA 函式 （tapi.h）

  • 發行項

lineGetAgentStatus 函式會取得指定位址上的代理程式相關狀態。

語法

LONG lineGetAgentStatusA(
  HLINE             hLine,
  DWORD             dwAddressID,
  LPLINEAGENTSTATUS lpAgentStatus
);

參數

hLine

開啟行裝置的句柄。

dwAddressID

開啟線路裝置上的位址，其代理程序狀態為要查詢。 地址標識碼與位址永久相關聯;標識碼在操作系統升級之間維持不變。

lpAgentStatus

LINEAGENTSTATUS 類型類型可變大小的指標。 成功完成要求后，此結構會填入代理程式狀態資訊。 在呼叫 lineGetAgentStatus之前，應用程式必須設定此結構的 dwTotalSize 成員，以指出 TAPI 可用來傳回資訊的記憶體數量。

注意 如果結構中的大小參數不正確，可能會覆寫記憶體。 如需設定結構大小的詳細資訊，請參閱 記憶體配置 主題。
 

傳回值

如果異步操作啟動時，會傳回正要求標識符;否則，下列其中一個負誤差值：

LINEERR_INVALADDRESSID、LINEERR_INVALLINEHANDLE、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_STRUCTURETOOSMALL、LINEERR_UNINITIALIZED。

言論

注意

tapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 lineGetAgentStatus 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
目標平臺 窗戶
標頭 tapi.h
連結庫 Tapi32.lib
DLL Tapi32.dll

另請參閱

LINEAGENTSTATUS

補充線路服務函式

TAPI 2.2 參考概觀