lineAnswer 函式 (tapi.h)

發行項
08/26/2023

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

語法

LONG lineAnswer(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

參數

hCall

要接聽之呼叫的控制碼。應用程式必須是此呼叫的擁有者。 hCall的撥號狀態必須提供或接受。

lpsUserUserInfo

Null終止字串的指標，其中包含在接聽通話時要傳送給遠端合作物件的使用者資訊。如果未傳送使用者使用者資訊，此指標可以保留 Null 。只有在基礎網路支援時，使用者使用者資訊才會傳送 (請參閱 LINEDEVCAPS) 。如有需要，使用者使用者資訊的通訊協定辨別子欄位應該顯示為 lpsUserUserInfo所指向之緩衝區的第一個位元組，而且必須在 dwSize中考慮。

dwSize

lpsUserUserInfo中使用者資訊的大小 (包括null結束字元) ，以位元組為單位如果lpsUserUserInfo為Null，則不會將使用者使用者資訊傳送給呼叫端，而且會忽略 dwSize。

傳回值

如果函式是以非同步方式完成，則傳回正要求識別碼，如果發生錯誤，則傳回負錯誤號碼。如果函式成功或發生錯誤，則對應LINE_REPLY訊息的dwParam2參數為零。可能的傳回值為：

LINEERR_INUSE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLSTATE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED、LINEERR_NOMEM LINEERR_USERUSERINFOTOOBIG LINEERR_NOTOWNER。

備註

當新的通話送達時，對通話感興趣的應用程式會傳送 LINE_CALLSTATE 訊息，以提供新的通話控制碼，並通知應用程式呼叫的狀態和新通話的許可權 (，例如監視或擁有者) 。具有通話擁有者許可權的應用程式可以使用 lineAnswer接聽此通話。成功接聽通話之後，呼叫通常會轉換成 已連線 狀態。一開始，只有一個應用程式具有連入呼叫的擁有者許可權。

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

如果在另一個通話已作用中時， (提供通話) ，則叫用 lineAnswer 會連線到新的通話。對現有作用中呼叫的影響取決於線路的裝置功能。第一個呼叫可能會不受影響、自動卸載，也可以自動暫留。適當的LINE_CALLSTATE訊息報告狀態會轉換至應用程式，以瞭解這兩個呼叫。

在橋接的情況下，如果呼叫已連線，但處於LINECONNECTEDMODE_INACTIVE狀態，則可以使用 lineAnswer 函式來聯結。

應用程式可以選擇在答案時傳送使用者使用者資訊。即使可以傳送使用者使用者資訊，也不保證網路會將此資訊傳遞給呼叫端。應用程式應該諮詢線路的裝置功能，以判斷在接聽通話時是否提供傳送使用者使用者資訊。