lineGetNewCalls 函式 (tapi.h)

發行項
03/02/2024

lineGetNewCalls 函式會傳回呼叫句柄，以呼叫應用程式目前沒有句柄的指定行或位址。應用程式會獲得這些呼叫的監視許可權。

語法

LONG lineGetNewCalls(
  HLINE          hLine,
  DWORD          dwAddressID,
  DWORD          dwSelect,
  LPLINECALLLIST lpCallList
);

參數

hLine

開啟行裝置的句柄。

dwAddressID

指定開啟行裝置上的位址。位址標識符永久與地址相關聯;標識碼在操作系統升級之間維持不變。

dwSelect

選取所要求的呼叫。此參數只會使用其中一個 LINECALLSELECT_常數。

lpCallList

LINECALLLIST 類型的可變大小數據結構的指標。成功完成要求時，會在此結構中傳回所有所選呼叫的呼叫句柄。在呼叫 lineGetNewCalls之前，應用程式必須設定此結構的 dwTotalSize 成員，以指出TAPI可用來傳回資訊的記憶體數量。

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

傳回值

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

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

備註

應用程式可以使用 lineGetNewCalls 來取得目前沒有句柄的呼叫。應用程式可以選取要傳回的句柄呼叫，方法是根據指定行上的範圍 (呼叫，或呼叫指定的位址) 。例如，應用程式可以要求呼叫句柄給目前沒有句柄之指定位址上的所有呼叫。應用程式一律會獲得新呼叫句柄的監視許可權。此外，開啟行時，應用程式會使用此函式來察覺現有的呼叫。

應用程式可以針對清單中的每個呼叫叫用 lineGetCallInfo 和 lineGetCallStatus ，以分別判斷呼叫的信息和狀態。它可以使用 lineSetCallPrivilege 將其許可權變更為擁有者。