共用方式為


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

另請參閱

LINECALLINFO

LINE_CALLSTATE

LINE_REPLY

增補行服務函式

TAPI 2.2 參考概觀

lineUncompleteCall