IXMLHTTPRequest3Callback::OnServerCertificateReceived method (msxml6.h)

Article
02/22/2024

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