lineSendUserUserInfo 函式 (tapi.h)

發行項
03/08/2023

lineSendUserUserInfo函式會在指定的呼叫時，將使用者使用者資訊傳送給遠端合作物件。

語法

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

參數

hCall

處理要傳送使用者使用者資訊的呼叫。應用程式必須是呼叫的擁有者。 hCall的撥號狀態必須已連線、供應專案、接受或回撥。

lpsUserUserInfo

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

dwSize

lpsUserUserUserInfo中使用者使用者資訊的大小，以位元組為單位。

傳回值

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

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

備註

此函式可用於在連線呼叫期間隨時傳送使用者使用者資訊。如果要傳送的指定資訊大小大於可放入單一網路訊息的大小， (ISDN) ，服務提供者會負責將資訊分割成一連串鏈結的網路訊息， (使用「更多資料」) 。

使用者使用者資訊也可以當做通話接受、通話拒絕和通話重新導向的一部分傳送，以及在撥打電話時傳送。您也可以接收使用者使用者資訊。接收的資訊可透過通話的通話資訊記錄取得。每當使用者資訊在通話供應專案或通話中斷連線之前抵達時，具有UserUserInfo參數的LINE_CALLINFO訊息會通知應用程式，呼叫資訊記錄中的使用者使用者資訊已變更。如果鏈結多個網路訊息，資訊會由服務提供者組合，並將單一訊息傳送至應用程式。

此函式可能會以未加密的形式透過網路傳送資料;因此，網路上有人竊聽可能會讀取資料。使用此方法之前，應該先考慮以純文字傳送資料的安全性風險。