IXtfApplicationClient::Constrain

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

Syntax

public:
HRESULT Constrain(
         LPCWSTR pszPackageMoniker
)  

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)Autorizzazione obbligatoria.

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)Autorizzazione obbligatoria.

Requirements

Header: xtfapplication.h

Library: xtfapplication.lib

Supported platforms: Windows (for Xbox console tools)

See also

IXtfApplicationClient::Unconstrain
IXtfApplicationClient
XtfApplication