IXMLHTTPRequest2::Send 方法 (msxml6.h)
以異步方式將 HTTP 要求傳送至伺服器。 成功時,會呼叫應用程式所實作 之 IXMLHTTPRequest2Callback 介面上的方法來處理回應。
語法
HRESULT Send(
[in, optional] ISequentialStream *pBody,
[in] ULONGLONG cbBody
);
參數
[in, optional] pBody
與要求一起傳送之訊息的本文。 系統會讀取此數據流,以便上傳非 GET 要求的數據。 對於不需要上傳的要求,請將此參數設定為 NULL。
[in] cbBody
要求所傳送訊息的長度,以位元組為單位。 對於不需要上傳的要求,請將此參數設定為 0。
傳回值
傳回成功時的 S_OK 。
備註
必須先呼叫 Open 方法,才能成功呼叫 Send 。
因為這個方法是異步的,所以它會在要求開始處理之前立即傳回。 應用程式將會透過 IXMLHTTPRequest2Callback 介面收到通知,因為要求處理中的進度。
針對 POST 要求使用 ISequentialStream 的替代方案包括 SHCreateMemStreamSHCreateStreamOnFile/ 傳統型應用程式,以及適用於 Windows 市集應用程式的 CreateStreamOverRandomAccessStream。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式],MSXML 6.0 和更新版本 |
最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | msxml6.h |