TSPI_lineReleaseUserUserInfo函式 (tspi.h)

發行項
03/03/2024

TSPI_lineReleaseUserUserInfo函式會通知服務提供者，已處理 LINECALLINFO 結構中包含的用戶使用者資訊，且後續收到的使用者資訊現在可以寫入該結構。服務提供者會傳送 LINE_CALLINFO 訊息，指出有新的資訊可用時LINECALLINFOSTATE_USERUSERINFO。

語法

LONG TSPIAPI TSPI_lineReleaseUserUserInfo(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

參數

dwRequestID

異步要求的標識碼。

hdCall

服務提供者對要釋放使用者資訊之呼叫的句柄。 hdCall 的呼叫狀態可以是任何。

傳回值

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

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL。

備註

TSPI_lineReleaseUserUserInfo函式允許控制ISDN連線上傳入使用者使用者資訊的流程。收到新的、完整的使用者資訊訊息時，服務提供者會使用指定LINECALLINFOSTATE_USERUSERINFO) LINE_CALLINFO 訊息 (通知TAPI。您可以透過多個呼叫來檢查 LINECALLINFO 中的使用者使用者資訊和其他欄位 TSPI_lineGetCallInfo。在呼叫 TSPI_lineReleaseUserUserInfo 之後，服務提供者不得以較新的資訊覆寫 LINECALLINFO 中的先前用戶資訊。服務提供者必須緩衝處理後續接收的用戶用戶資訊，直到釋放先前的信息為止。叫用 TSPI_lineCloseCall 時，可以捨棄任何剩餘的緩衝資訊。

如果在 LINECALLINFO 中沒有使用者使用者資訊時叫用此函式，則服務提供者仍應該傳回成功指示。

為了回溯相容性，TAPI 會自動傳回LINEERR_OPERATIONUNAVAIL，如果在未匯出函式的服務提供者控件下，針對該行上的呼叫叫用此函式。