IXtfApplicationClient::SetDefaultApp
Sets the ID of the application to launch when an activation request is received for a specific title ID.Syntax
Parameters
pszTitleIdType: 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 ReturnsS_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 thexbapp 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).
To maximize future compatibility, your tools should use the
xbapp setdefaultapp command from the Application Management tool, instead of directly invoking this method.pszAumid determines which version of an application to launch when a game is launched from the shell or when another app launches the game.
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)See also
IXtfApplicationClient InterfaceXtfApplication