Skip to main content

​
IXtfConsoleManager::AddConsole method

Adds a development console to the IXtfConsoleManager instance.

​
Syntax

​
Parameters

pszAlias
Type: LPCWSTR A pointer to the name of the console to add. pszAddress
Type: LPCWSTR A pointer to the Tools IP address of the console to add. dwFlags
Type: XTF_ADD_CONSOLE_FLAGS A combination of bitwise-OR flags that specify how to add the console to the instance. The following table describes the available flags.

​
Return value

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

​
Remarks

This method adds the development console specified in pszAddress, using the name specified in pszAlias, to the IXtfConsoleManager instance. If XTF_ADD_CONSOLE_FLAGS_SETDEFAULT is specified in dwFlags, the development console is also set as the default development console for this PC. For more information about the default development console, see IXtfConsoleManager::SetDefaultConsole Method. After this method is successfully called, the IXtfConsoleManager instance invokes the OnAddConsole callback method from the associated IXtfConsoleManagerCallback instance. If XTF_ADD_CONSOLE_FLAGS_SETDEFAULT is specified in dwFlags, the OnChangedDefaultConsole callback method from the associated IXtfConsoleManagerCallback instance is also invoked. For more information about connecting and querying development consoles, see Connect (xbconnect.exe) (NDA topic).

​
Requirements

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

​
See also

IXtfConsoleManager::GetConsole Method
IXtfConsoleManager::RemoveConsole Method
IXtfConsoleManager Interface
XtfConsoleManager
Last modified on August 20, 2026

Related topics

IXtfConsoleManagerCallback::OnAddConsole MethodIXtfConsoleManagerCallback::OnChangedDefaultConsole MethodIXtfConsoleManager::EnumerateConsoles methodIXtfConsoleManager::GetConsole MethodIXtfConsoleManager::RemoveConsole Method