lineCompleteCall 函式 (tapi.h)

發行項
03/05/2024

lineCompleteCall 函式會指定如何改為完成無法正常連接的呼叫。網路或交換器可能無法完成通話，因為網路資源忙碌中或遠端月臺忙碌或未接聽。應用程式可以透過數種方式之一要求完成呼叫。

語法

LONG lineCompleteCall(
  HCALL   hCall,
  LPDWORD lpdwCompletionID,
  DWORD   dwCompletionMode,
  DWORD   dwMessageID
);

參數

hCall

處理要求完成的呼叫。應用程式必須是呼叫的擁有者。 hCall 的呼叫狀態必須是忙碌或迴響。

lpdwCompletionID

DWORD 大小的記憶體位置指標。完成標識碼是用來識別進行中的個別完成要求。完成標識碼會變成無效，而且可以在要求完成或取消未完成的要求之後重複使用。

dwCompletionMode

呼叫完成的方式。此參數只會使用其中一個 LINECALLCOMPLMODE_常數。

dwMessageID

使用 LINECALLCOMPLMODE_MESSAGE 完成呼叫時要傳送的訊息。此標識元會從少量預先定義的訊息中選取訊息。

傳回值

如果函式是以異步方式完成，則傳回正要求標識碼，如果發生錯誤，則傳回負錯誤號碼。如果函式成功，則對應LINE_REPLY訊息的 dwParam2 參數為零，如果發生錯誤，則為負錯誤號碼。可能的傳回值為：

LINEERR_COMPLETIONOVERRUN、LINEERR_NOMEM、LINEERR_INVALCALLCOMPLMODE、LINEERR_NOTOWNER、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALMESSAGEID、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED。

備註

當網路或交換器已接受要求時，此函式會視為完成;當要求以指定的方式完全完成時，則不是。此函式完成之後，呼叫通常會轉換為閑置。當被呼叫的月臺或網路進入可依要求完成呼叫的狀態時，應用程式會透過呼叫狀態等於供應專案的LINE_CALLSTATE訊息收到通知。呼叫的 LINECALLINFO 記錄會列出呼叫為 CALLCOMPLETION 的原因，並提供完成標識符。可以有多個未完成的呼叫完成要求;最大數目取決於裝置。完成標識碼也可用來參考每個個別要求，以便呼叫 lineUncompleteCall來取消要求。