lineGetConfRelatedCalls 函式 (tapi.h)

發行項
03/13/2024

lineGetConfRelatedCalls 函式會傳回呼叫句柄的清單，這些句柄屬於與指定通話相同的通話一部分。指定的通話是電話會議或通話中的參與者通話。新句柄是針對應用程式尚未擁有句柄的呼叫所產生，而且應用程式會被授與這些呼叫的監視許可權。

語法

LONG lineGetConfRelatedCalls(
  HCALL          hCall,
  LPLINECALLLIST lpCallList
);

參數

hCall

呼叫的句柄。這是電話會議或會議通話中的參與者通話。對於會議父通話， hCall 的通話狀態可以是任何狀態。對於會議參與者通話，它必須處於會議狀態。

lpCallList

LINECALLLIST 類型的可變大小數據結構的指標。成功完成要求時，會在此結構中傳回通話中所有通話的通話句柄。清單中的第一個通話是電話會議，其他通話則是參與者通話。應用程式會被授與監視許可權給其尚未擁有句柄的呼叫;應用程式已擁有句柄的清單中呼叫的許可權保持不變。在呼叫 lineGetConfRelatedCalls之前，應用程式必須設定此結構的 dwTotalSize 成員，以指出TAPI可用來傳回資訊的記憶體數量。

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

傳回值

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

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

備註

指定的通話可以是會議通話句柄或參與者通話的句柄。例如，尚未新增至會議通話的諮詢通話不屬於會議。傳回清單中的第一個專案是會議通話句柄，其他句柄則是所有參與者通話。指定的呼叫一律是清單中傳回的其中一個呼叫。在清單中，應用程式還沒有呼叫句柄的呼叫會獲指派監視許可權;應用程式已經擁有句柄之呼叫的許可權不會變更。應用程式可以使用 lineSetCallPrivilege 來變更呼叫的許可權。

如果在使用 lineCompleteTransfer 將通話新增至會議之後立即呼叫 lineGetConfRelatedCalls，lineGetConfRelatedCalls 可能不會傳回相關通話的完整清單，因為 TAPI 會等候收到LINE_CALLSTATE訊息，指出通話 LINECALLSTATE_CONFERENCED在將通話視為會議實際成為會議 (的一部分，也就是服務提供者會確認會議狀態) 。應用程式收到LINE_CALLSTATE訊息之後， lineGetConfRelatedCalls 會傳回完整的資訊。

應用程式可以針對清單中的每個呼叫叫用 lineGetCallInfo 和 lineGetCallStatus ，分別判斷呼叫的信息和狀態。