次の方法で共有

IXtfConsoleManager::AddConsole メソッド

  • [アーティクル]

IXtfConsoleManager インスタンスに開発機本体を追加します。

構文

public:
HRESULT AddConsole(
         LPCWSTR pszAlias,
         LPCWSTR pszAddress,
         XTF_ADD_CONSOLE_FLAGS dwFlags
)

パラメーター

pszAlias
型: LPCWSTR

追加する本体の名前へのポインター。

pszAddress
型: LPCWSTR

追加する本体の Tools IP アドレスへのポインター。

dwFlags
型: XTF_ADD_CONSOLE_FLAGS

インスタンスに本体を追加する方法を指定するビット単位の OR フラグの組み合わせ。 次の表では、使用できるフラグについて説明します。

値 マクロ 説明
0x0 XTF_ADD_CONSOLE_FLAGS_NONE フラグは指定されていません。
0x1 XTF_ADD_CONSOLE_FLAGS_SETDEFAULT 開発機本体を追加した後、これをこの PC の既定の開発機本体として設定します。

戻り値

型: HRESULT

正常に実行された場合は S_OK を返し、失敗した場合は HRESULT エラー コードを返します。

解説

このメソッドでは、pszAlias で指定された名前を使用して、pszAddress で指定された開発機本体を IXtfConsoleManager インスタンスに追加します。 XTF_ADD_CONSOLE_FLAGS_SETDEFAULT が dwFlags で指定されている場合、開発機本体は、この PC の既定の開発機本体としても設定されます。 既定の開発機本体の詳細については、「IXtfConsoleManager::SetDefaultConsole メソッド」を参照してください。

このメソッドが正常に呼び出されると、IXtfConsoleManager インスタンスによって、関連付けられた IXtfConsoleManagerCallback インスタンスから OnAddConsole コールバック メソッドが呼び出されます。 XTF_ADD_CONSOLE_FLAGS_SETDEFAULT が dwFlags で指定されている場合は、関連付けられた IXtfConsoleManagerCallback インスタンスから OnChangedDefaultConsole コールバック メソッドも呼び出されます。

開発機本体の接続とクエリについて詳しくは、「接続 (xbconnect.exe) (NDA トピック)」を参照してください。

要件

ヘッダー: xtfconsolemanager.h

ライブラリ: xtfconsolemanager.lib

サポートされているプラットフォーム: Windows (Xbox 本体ツール用)

関連項目

IXtfConsoleManager::GetConsole メソッド
IXtfConsoleManager::RemoveConsole メソッド
IXtfConsoleManager インターフェイス
XtfConsoleManager