lineGetCallStatus 函式 (tapi.h)

發行項
08/26/2023

lineGetCallStatus函式會傳回指定呼叫的目前狀態。

語法

LONG lineGetCallStatus(
  HCALL            hCall,
  LPLINECALLSTATUS lpCallStatus
);

參數

hCall

要查詢之呼叫的控制碼。 hCall的撥號狀態可以是任何狀態。

lpCallStatus

LINECALLSTATUS類型的可變大小資料結構的指標。成功完成要求時，此結構會填入撥號狀態資訊。在呼叫 lineGetCallStatus之前，應用程式必須設定這個結構的 dwTotalSize 成員，以指出 TAPI 可用來傳回信息的記憶體數量。

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

傳回值

如果要求成功或發生錯誤，則傳回零。可能的傳回值為：

LINEERR_INVALCALLHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NOMEM、LINEERR_UNINITIALIZED、LINEERR_OPERATIONFAILED、LINEERR_OPERATIONUNAVAIL。

備註

lineGetCallStatus函式會傳回呼叫的動態狀態，而 lineGetCallInfo主要會傳回有關呼叫的靜態資訊。撥號狀態資訊包括目前的撥號狀態、當處於此狀態時與呼叫相關的詳細模式資訊，如果有任何) ，以及應用程式在此狀態時，應用程式可以在呼叫上叫用的可用 API 函式清單 (。當應用程式收到LINE_CALLSTATE訊息有關撥號狀態變更的通知時，應用程式通常會有興趣要求這項資訊。