IXtfApplicationClient::SetDefaultApp Method

Sets the ID of the application to launch when an activation request is received for a specific title ID.

The default App User Model ID (AUMID) is used to determine which version of an application to launch when a game is launched from the shell or another app launches the game.

Syntax

public:
HRESULT SetDefaultApp(
         LPCWSTR pszTitleId,
         LPCWSTR pszAumid
)

Parameters

pszTitleId
Type: LPCWSTR

The title ID scheme to change the defaults for.

pszAumid
Type: LPCWSTR

Pointer to a string that contains the AUMID of the app to launch.

Return value

Type: HRESULT

HRESULT success or error code.

Remarks

SetDefaultApp is used to implement the xbapp.exe setdefaultapp command. To maximize future compatibility, your tools should call xbapp.exe rather than use this function directly.

Note that when a title calls the CoreApplication.Restart Method, the default value is temporarily overridden with the AUMID of the currently running version of the title, to ensure that the same version is launched on restart.

Requirements

Header: Declared in xtfapplication.h.

Library: Use xtfapplication.lib.