Export (0) Print
Expand All

IXMLHTTPRequest2Callback::OnHeadersAvailable method

Occurs after an HTTP request has been sent to the server and the server has responded with response headers.

Syntax


HRESULT OnHeadersAvailable(
  [in, optional]  IXMLHTTPRequest2 *pXHR,
  [in]            DWORD dwStatus,
  [in]            const WCHAR *pwszStatus
);

Parameters

pXHR [in, optional]

The initial HTTP request object that returns the headers.

dwStatus [in]

The status code for the request.

Note  Possible values for this parameter also include the HTTP_STATUS_* values defined by winhttp.h for desktop apps.

pwszStatus [in]

The status code for the request appearing in human-readable form as a null-terminated string.

Return value

Returns S_OK on success.

Note  This callback function must not throw exceptions.

Remarks

To view an individual response header, call the GetResponseHeader method on the IXMLHTTPRequest2 interface. To view all response headers, call the GetAllResponseHeaders method. To cancel the request, call the Abort method On the pXHR object.

Requirements

Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Version

MSXML 6.0 and later

Header

Msxml6.h

IDL

Msxml6.idl

See also

GetResponseHeader Method
GetAllResponseHeaders Method
OnHeadersAvailable
IXMLHTTPRequest2
IXMLHTTPRequest2Callback

 

 

Community Additions

ADD
Show:
© 2014 Microsoft