XNetworkingQuerySecurityInformationForUrlUtf16Async

Article
2025-04-28

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

Syntax

HRESULT XNetworkingQuerySecurityInformationForUrlUtf16Async(
         const wchar_t* url,
         XAsyncBlock* asyncBlock
)

Parameters

url _In_z_
Type: wchar_t*

URL endpoint that retrieves the list of certificate thumbprints.

asyncBlock _Inout_
Type: XAsyncBlock*

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

Return value

Type: HRESULT

HRESULT success or error code of the async call.

Remarks

This function starts an async request for the certificates associated with an URL configured for the 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.

Note

When making custom web requests to the Xbox Live service endpoints, allow the Xbox Services API (XSAPI) library to automatically perform the certificate pinning.

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