TSPI_lineReleaseUserUserInfo函式 (tspi.h)
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,如果在未匯出函式的服務提供者控件下,針對該行上的呼叫叫用此函式。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tspi.h |