IXMLHttpRequest::send Method

This document describes the proposed design to be delivered with Internet Explorer 5, and differs slightly from the implementation provided with this Internet Explorer 5 Beta. We encourage you to evaluate these features and to send us your feedback. Please note that these features are subject to change.

Sends an HTTP request to the server and receives a response.

Syntax

HRESULT send(
    VARIANT varHeader);

Parameters

varHeader

[in] Case-insensitive header name.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

This method is synchronous or asynchronous depending on the value of the bAsync parameter in the open call. If open is called with bAsync == False, this call does not return until the entire response is received or the protocol stack times out. If open is called with bAsync == True, this call returns immediately.

This method takes one parameter, which is the requestBody to use. The acceptable VARIANT input types are BSTR, SAFEARRAY of UI1 (unsigned bytes), IDispatch to an XMLDOM object, and IStream *. You can only use chunked encoding (for sending) when sending IStream * input types. The component automatically sets the Content-Length header for all but IStream * input types.

If the input type is a BSTR, the response is always encoded as UTF8. The caller must set a Content-Type header with the appropriate content type and include a charset parameter.

If the input type is a SAFEARRAY of UI1, the response is sent as is without additional encoding. The caller must set a Content-Type header with the appropriate content type.

If the input type is an XMLDOM object, the response is encoded as UTF8 or UCS2. The component sets a Content-Type header with the appropriate content type and includes a charset parameter.

If the input type is an IStream *, the response is sent as is without additional encoding. The caller must set a Content-Type header with the appropriate content type.