Skip to main content

IXtfApplicationClient::Constrain

Places the app with the specified package moniker into constrained mode.

Syntax

Parameters

pszPackageMoniker
Type: LPCWSTR
A pointer to the package moniker for the app that is to be put into constrained mode.

Return value

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

Remarks

This function puts the app specified in pszPackageMoniker into constrained mode. While in constrained mode, the app has reduced access to reserved system resources. Use the Unconstrain method to leave constrained mode and return to full mode. For more information about game life cycle states, see XBOX Game Life Cycle (NDA topic). For more information about how to use XBOX Tools Framework (XTF) to constrain and unconstrain an app for testing, see Application Management (xbapp.exe) (NDA topic).

Requirements

Header: xtfapplication.h Library: xtfapplication.lib Supported platforms: Windows (for XBOX console tools)

See also

IXtfApplicationClient::Unconstrain
IXtfApplicationClient
XtfApplication
Last modified on August 20, 2026