IXMLHTTPRequest3Callback::OnServerCertificateReceived method

Occurs when a client receives certificate errors or a server certificate chain during SSL negotiation with the server.

Syntax


HRESULT OnServerCertificateReceived(
  [in]                                                 IXMLHTTPRequest3 *pXHR,
  [in]                                                 DWORD            dwCertificateErrors,
  [in]                                                 DWORD            cServerCertificateChain,
  [in, size_is(cServerCertificateChain), unique] const XHR_CERT         *rgServerCertificateChain
);

Parameters

pXHR [in]

The initial HTTP request.

dwCertificateErrors [in]

The certificate errors encountered in the HTTPS connection (see XHR_CERT_ERROR_FLAG).

cServerCertificateChain [in]

The number of elements in the rgServerCertChain parameter.

rgServerCertificateChain [in]

An array of XHR_CERT structures that represent the server certificate chain.

Return value

Returns S_OK on success.

Remarks

Note  This callback method must not throw exceptions.
 

Requirements

Minimum supported client

Windows 8.1 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 R2 [desktop apps | Windows Store apps]

Minimum supported phone

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

IDL

Msxml6.idl

See also

XHR_CERT_ERROR_FLAG
IXMLHTTPRequest3
IXMLHTTPRequest3Callback
SetProperty
XHR_CERT

 

 

Community Additions

ADD
Show: