lineCompleteCall 函式 (tapi.h)
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來取消要求。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tapi.h |
程式庫 | Tapi32.lib |
Dll | Tapi32.dll |