共用方式為


lineGetConfRelatedCalls 函式 (tapi.h)

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 會傳回完整的資訊。

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

規格需求

需求
目標平台 Windows
標頭 tapi.h
程式庫 Tapi32.lib
Dll Tapi32.dll

另請參閱

基本電話語音服務參考

LINE_CALLSTATE

TAPI 2.2 參考概觀

lineCompleteTransfer

lineGetCallInfo

lineGetCallStatus

lineSetCallPrivilege