IXMLHTTPRequest3Callback::OnServerCertificateReceived method (msxml6.h)

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] const XHR_CERT   *rgServerCertificateChain
);

Parameters

[in] pXHR

The initial HTTP request.

[in] dwCertificateErrors

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

[in] cServerCertificateChain

The number of elements in the rgServerCertChain parameter.

[in] rgServerCertificateChain

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

Requirement Value
Minimum supported client Windows 8.1 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 R2 [desktop apps | UWP apps]
Target Platform Windows
Header msxml6.h

See also

IXMLHTTPRequest3

IXMLHTTPRequest3Callback

SetProperty

XHR_CERT

XHR_CERT_ERROR_FLAG