XtfRegisterAllPackagesOnDrive

Register all packages deployed on the specified drive.

Syntax

HRESULT XtfRegisterAllPackagesOnDrive(
         LPCWSTR address,
         DWORD drive,
         LPBSTR pbstrPackageList
)  

Parameters

address
Type: LPCWSTR

[in] The address of the console.

drive
Type: DWORD

[in] The drive to register the packages on. This parameter accepts the following values:

Value Description
0 Retail drive
1 Development drive
2 - 8 External drive 1 through external drive 7

pbstrPackageList
Type: LPBSTR

[out] Information about the packages and apps that were registered.

Return value

Type: HRESULT

Returns S_OK if successful; otherwise, returns an HRESULT error code.

Remarks

This function registers all packages deployed on the specified drive, such as an external drive, and provides a stringified JSON object in pbstrPackageList. The JSON object is an array that provides the package full name and the apps, including the Application User Model IDs (AUMIDs), for each registered package.

For more information about managing applications, see Application Management (xbapp.exe) (NDA topic)Authorization required.

Requirements

Header: xtfapi.h

Library: XtfApi.lib

Supported platforms: Windows (for Xbox console tools)

See also

Run from PC Deployment (NDA topic)Authorization required
XTF Transport Errors (NDA topic)Authorization required
Additional Xtf APIs