共用方式為


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

另請參閱

ISequentialStream 介面

IXMLHTTPRequest2Callback