lineAccept 函式 (tapi.h)

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

語法

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

參數

hCall

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

lpsUserUserInfo

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

dwSize

lpsUserUserInfo 中使用者資訊的大小, (以位元組為單位包含 null 終止符) 。 如果 lpsUserUserInfoNULL,則不會傳送使用者使用者資訊給呼叫方,而且會忽略 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 函式。 其他應用程式可以使用呼叫狀態轉換為已接受的呼叫狀態,以表示另一個應用程式已宣告呼叫責任,並向用戶呈現呼叫。

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

規格需求

需求
目標平台 Windows
標頭 tapi.h
程式庫 Tapi32.lib
Dll Tapi32.dll

另請參閱

接受概觀

LINEDEVCAPS

LINE_REPLY

增補線路服務函式

lineAnswer

lineDrop

lineRedirect