XStoreDownloadAndInstallPackagesResult

Artigo
06/22/2023

Gets the results for a call to XStoreDownloadAndInstallPackagesAsync.

Syntax

HRESULT XStoreDownloadAndInstallPackagesResult(  
         XAsyncBlock* async,  
         uint32_t count,  
         char packageIdentifiers[][XPACKAGE_IDENTIFIER_MAX_LENGTH]  
) noexcept;

Parameters

async _Inout_
Type: XAsyncBlock*

The XAsyncBlock that was passed to XStoreDownloadAndInstallPackagesAsync. The XAsyncBlock can be used to poll for the call's status and retrieve call results. See XAsyncBlock for more information.

count _In_
Type: uint32_t

The size in elements of the array passed into the packageIdentifiers parameter.

packageIdentifiers _Out_writes_z_(count)
Type: char[][XPACKAGE_IDENTIFIER_MAX_LENGTH]

On success contains a list of package identifiers for the packages that were downloaded. For more information about package identifiers, see Manage and license downloadable content (DLC).

Return value

Type: HRESULT

S_OK on success; otherwise, returns an error code.

Remarks

This result function allows you to retrieve the execution results of XStoreDownloadAndInstallPackagesAsync, as well as the store packages that were called for if the execution was successful. As such, this function should be called after XStoreDownloadAndInstallPackagesAsync has been called, usually in the context of a callback function.

See XStoreDownloadAndInstallPackagesAsync for a usage example.

Requirements

Header: XStore.h (included in XGameRuntime.h)

Library: xgameruntime.lib

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

Compartilhar via