Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Sets the ID of the application to launch when an activation request is received for a specific title ID.
Syntax
public:
HRESULT SetDefaultApp(
LPCWSTR pszTitleId,
LPCWSTR pszAumid
)
Parameters
pszTitleId
Type: LPCWSTR
The title ID scheme to change the defaults for.
pszAumid
Type: LPCWSTR
A pointer to a string that contains the AUMID of the app to launch.
Return value
Type: HRESULT
Returns S_OK if successful; otherwise, returns an HRESULT error code.
Remarks
This method sets the ID of the application to launch when an activation request is received for a specific title ID. This method is similar to the xbapp setdefaultapp command from the Application Management (xbapp.exe) tool, included as part of the Xbox Tools Framework (XTF). For more information about the xbapp setdefaultapp command, see Application Management (xbapp.exe) (NDA topic)Authorization required.
Note
To maximize future compatibility, your tools should use the xbapp setdefaultapp command from the Application Management tool, instead of directly invoking this method.
The default App User Model ID (AUMID) specified in pszAumid determines which version of an application to launch when a game is launched from the shell or when another app launches the game.
Note
When a title calls XLaunchNewGame, 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: xtfapplication.h
Library: xtfapplication.lib
Supported platforms: Windows (for Xbox console tools)