TSPI_lineAccept函式 (tspi.h)

發行項
08/26/2023

TSPI_lineAccept函式會接受指定的提供呼叫。它可以選擇性地將指定的使用者使用者資訊傳送給呼叫端。

語法

LONG TSPIAPI TSPI_lineAccept(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

參數

dwRequestID

非同步要求的識別碼。

hdCall

要接受之呼叫的控制碼。 hdCall的呼叫狀態可以提供。

lpsUserUserInfo

Null終止 Unicode 字串的指標，其中包含要傳送給遠端合作物件做為呼叫接受一部分的使用者使用者資訊。如果未傳送任何使用者使用者資訊，則此指標為 Null 。只有在基礎網路支援時，才會傳送使用者使用者資訊 (請參閱 LINEDEVCAPS) 。

dwSize

lpsUserUserUserInfo中使用者資訊的大小，以位元組為單位。如果 lpsUserUserInfo 為 Null， 則會忽略 dwSize 。

傳回值

如果函式是以非同步方式完成，則傳回 dwRequestID ;如果發生錯誤，則傳回錯誤號碼。如果函式成功，則對應ASYNC_COMPLETION的lResult參數為零;如果發生錯誤，則為錯誤號碼。可能的傳回值如下所示：

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLSTATE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_USERUSERINFOTOOBIG LINEERR_OPERATIONUNAVAIL。

備註

TSPI_lineAccept函式用於電話語音環境 (例如 ISDN) ，允許與來電相關聯的警示與呼叫的初始供應專案分開。呼叫傳入時，會先提供通話。在一些短時間內，用戶端應用程式可以選擇使用 TSPI_lineDrop 拒絕通話、使用 TSPI_lineRedirect將通話重新導向至另一個月臺、使用TSPI_lineAnswer接聽通話，或使用TSPI_lineAccept接受通話。成功接受通話之後，呼叫端和通話裝置都會開始發出警示，而且撥號狀態通常會轉換為 已接受 的狀態。如果應用程式必須呼叫 TSPI_lineAccept，才能開始警示，服務提供者必須在LINEADDRESSCAPS資料結構的dwAddrCapFlags成員中設定旗標LINEADDRCAPFLAGS_ACCEPTTOALERT。

若要 TAPI，系統會使用具有響鈴指示的LINE_LINEDEVSTATE訊息來報告警示。

非 ISDN 服務提供者也可能支援TSPI_lineAccept。其他 TAPI 用戶端可以使用撥號狀態轉換為 已接受 狀態的撥號狀態，表示某些應用程式已宣告呼叫責任，並已向使用者呈現呼叫。

用戶端應用程式可以選擇在接受時傳送使用者使用者資訊。即使可以傳送使用者使用者資訊，通常不保證網路會將這項資訊傳遞給呼叫方。用戶端應用程式可能會諮詢線路的裝置功能，以判斷是否可使用呼叫接受。