TSPI_lineSendUserUserInfo函式 (tspi.h)

發行項
08/26/2023

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

語法

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

參數

dwRequestID

非同步要求的識別碼。

hdCall

要傳送使用者資訊之呼叫的控制碼。 hdCall的撥號狀態可以連線、供應專案、接受或回撥。

lpsUserUserInfo

Null終止 Unicode 字串的指標，其中包含要傳送給遠端合作物件的使用者使用者資訊。只有在基礎網路支援時，才會傳送使用者使用者資訊 (請參閱 LINEDEVCAPS) 。

dwSize

lpsUserUserInfo中使用者資訊的大小，以位元組為單位，包括Null結束字元。

傳回值

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

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

備註

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

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