TSPI_lineCompleteCall函式 (tspi.h)

發行項
03/03/2024

TSPI_lineCompleteCall函式是用來指定如何改為完成無法正常連接的呼叫。網路或交換器可能無法完成通話，因為網路資源忙碌中或遠端月臺忙碌或未接聽。

語法

LONG TSPIAPI TSPI_lineCompleteCall(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPDWORD       lpdwCompletionID,
  DWORD         dwCompletionMode,
  DWORD         dwMessageID
);

參數

dwRequestID

異步要求的標識碼。

hdCall

服務提供者對要求完成的呼叫句柄。 hdCall 的呼叫狀態可以是忙碌、迴響或繼續。

lpdwCompletionID

服務提供者寫入完成標識碼之 DWORD 大小的記憶體位置指標。這會在包含 hdCall 的行上唯一識別進行中的完成要求。特別是，完成標識碼會在要求完成或使用 TSPI_lineUncompleteCall 函式取消之後變成無效。服務提供者可以在完成標識碼變成無效時立即重複使用。

dwCompletionMode

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

dwMessageID

使用 LINECALLCOMPLMODE_MESSAGE 完成呼叫時要傳送的訊息。此標識元會從少量預先定義的訊息中選取訊息。呼叫此函式時，TAPI 不會驗證此參數。

傳回值

如果發生錯誤，則傳回 dwRequestID 或錯誤號碼。如果函式成功，則對應ASYNC_COMPLETION的 lResult 實際參數為零;如果發生錯誤，則為錯誤號碼。可能的傳回值如下所示：

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

備註

當網路或交換器接受要求時，此函式會被視為完成;當要求以指定的方式完全完成時，則不是。當呼叫站或網路進入可依要求完成呼叫的狀態時，服務提供者必須傳送 LINE_CALLSTATE 訊息，且呼叫狀態等於 供應專案。呼叫的 LINECALLINFO 記錄會列出呼叫為 CALLCOMPLETION 的原因，並提供完成標識符。在任何指定時間都可能會有多個呼叫完成要求;最大數目取決於裝置。完成標識碼也可用來參考每個個別要求，以便藉由呼叫 TSPI_lineUncompleteCall 來取消要求。