lineAccept 函式 (tapi.h)

發行項
03/02/2024

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

語法

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

參數

hCall

要接受之呼叫的句柄。應用程式必須是呼叫的擁有者。 hCall 的呼叫狀態必須提供。

lpsUserUserInfo

Null 終止字串的指標，其中包含要傳送給遠端合作物件做為呼叫接受的一部分的用戶資訊。如果未傳送使用者使用者資訊，此指標可以保留 NULL 。只有在基礎網路支援時，用戶使用者資訊才會傳送 (請參閱 LINEDEVCAPS) 。如有需要，使用者使用者信息的通訊協議辨別成員應該顯示為 lpsUserUserInfo 所指向之緩衝區的第一個字節，而且必須在 dwSize 中考慮。

dwSize

lpsUserUserInfo 中使用者資訊的大小， (以位元組為單位包含 null 終止符) 。如果 lpsUserUserInfo 為 NULL，則不會傳送使用者使用者資訊給呼叫方，而且會忽略 dwSize 。

傳回值

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

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

備註

lineAccept 函式用於電話語音環境中，例如整合式服務數位網路 (ISDN) ，允許與來電相關聯的警示與呼叫的初始供應專案分開。呼叫出現時，會先提供呼叫。對於一些少量的時間，應用程式可以選擇使用 lineDrop拒絕通話、使用 lineRedirect將呼叫重新導向至另一個月臺、使用 lineAnswer接聽通話，或使用 lineAccept接受通話。應用程式成功接受通話之後，警示會從呼叫和呼叫的裝置開始，而呼叫狀態通常會轉換為 已接受。

警示會由具有環形指示的LINE_LINEDEVSTATE訊息回報給應用程式。

非 ISDN 服務提供者也可能支援 lineAccept 函式。其他應用程式可以使用呼叫狀態轉換為已接受的呼叫狀態，以表示另一個應用程式已宣告呼叫責任，並向用戶呈現呼叫。

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