TSPI_lineAnswer函式 (tspi.h)

發行項
03/13/2024

TSPI_lineAnswer函式會回答指定的供應專案呼叫。

語法

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

參數

dwRequestID

異步要求的標識碼。

hdCall

服務提供者對要接聽之呼叫的句柄。 hdCall 的呼叫狀態可以提供或接受。

lpsUserUserInfo

Null 終止字串的指標，包含接聽通話時要傳送給遠端合作對象的用戶資訊。如果此指標為 NULL，表示不會傳送任何用戶用戶資訊。只有在基礎網路 (支援時，才會傳送用戶用戶資訊，如 LINEDEVCAPS) 所示。

dwSize

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

傳回值

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

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

備註

當新的呼叫送達時，服務提供者會傳送TAPI LINE_NEWCALL 訊息來交換通話的句柄。服務提供者會使用 LINE_CALLSTATE 訊息追蹤此專案，以通知TAPI及其用戶端應用程式呼叫的狀態。用戶端應用程式通常會使用 TSPI_lineAnswer 來接聽呼叫。一般而言，成功接聽通話之後，通話會轉換為 已連線 狀態。

在某些電話語音環境中 (ISDN) 使用者警示與通話供應專案不同，TAPI 及其用戶端應用程式可以選擇在接聽之前先接受通話，或改為拒絕或重新導向 供應專案 通話。

如果在另一個通話已在使用中時提供通話，則會藉由叫用 TSPI_lineAnswer來連線新的呼叫。這對現有作用中呼叫的影響取決於線路的裝置功能。第一個呼叫可能會不受影響，可能會自動卸除，或自動保留。適當的LINE_CALLSTATE訊息可用來報告這兩個呼叫的TAPI狀態轉換。