XNetworkingQuerySecurityInformationForUrlAsync

Article
06/22/2023

Retrieves additional security information associated with a URL configured in the Universal Developer Portal for Xbox Live-enabled titles.

Syntax

HRESULT XNetworkingQuerySecurityInformationForUrlAsync(
         const char* url,
         XAsyncBlock* asyncBlock
)

Parameters

url _In_z_
Type: char*

URL of the security information and list of certificate thumbprints.

asyncBlock _Inout_
Type: XAsyncBlock*

Pointer to the XAsyncBlock structure that gets passed to XAsyncRun function.

Return value

Type: HRESULT

HRESULT success or error code of the async call.

Remarks

This function starts an async request for the security information associated with a URL that was configured for a title through the Universal Developer Portal. This allows Xbox Live-enabled Microsoft Game Development Kit (GDK) titles to perform certificate pinning for custom title-specific service endpoints when paired with the Windows HTTP Services (WinHTTP) API. It is also required when making any custom web requests to the Xbox Live service endpoints. The Xbox Services API (XSAPI) library handles this requirement automatically.

This method interrogates the local state within the calling process and returns quickly, so it is safe to call from time-sensitive contexts.

Requirements

Header: XNetworking.h

Library: xgameruntime.lib

Supported platforms: Windows, Xbox One family consoles and Xbox Series consoles

Share via