IXMLHTTPRequest2Callback::OnResponseReceived 方法 (msxml6.h)
發生於用戶端收到來自伺服器的完整回應時。
語法
HRESULT OnResponseReceived(
[in, optional] IXMLHTTPRequest2 *pXHR,
[in, optional] ISequentialStream *pResponseStream
);
參數
[in, optional] pXHR
初始 HTTP 要求物件
[in, optional] pResponseStream
正在接收的回應數據流。 用戶端可以呼叫 ISequentialStream::Read 開始處理數據,也可以儲存 pResponseStream 的參考以供稍後處理。 此回應數據流會包裝在數據流同步處理物件中,以防止並行讀取和寫入作業,因此應用程式不需要實作自定義同步處理。
傳回值
傳回成功時的 S_OK 。
注意 這個回呼函式不得擲回例外狀況。
備註
當此事件引發時,應用程式可以從 HTTP 回應開始處理數據。 如果發生先前的 OnDataAvailable 事件,處理可能會在引發此事件之前開始。
除非呼叫 OnError ,否則 對 OnResponseReceived 的呼叫是最終回呼。 客戶端應該執行任何必要的清除,包括釋放 IXMLHTTPRequest2 對象的參考。
自定義數據流會收到 ISequentialStream::Write 的呼叫,指定在 引發 OnResponseReceived 之前寫入的 0 個字節。 用戶端可以直接從 Write 呼叫處理數據,而不是在自定義數據流上呼叫 ISequentialStream::Read ,而且可以依賴零位元組寫入呼叫來指出已收到回應。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式],MSXML 6.0 和更新版本 |
最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | msxml6.h |