Skip to main content

XtfSetOverlayFolder

特定のパッケージ完全名に関連付けられたオーバーレイ フォルダーの値を設定またはリセットします。

構文

パラメーター

address
型: PCWSTR
[in] 本体のアドレスへのポインターです。 packageFullName
型: PCWSTR
[in] アプリのパッケージ完全名へのポインターです。 overlayFolderPath
型: PCWSTR
[in] オーバーレイ フォルダーのパスを含む文字列へのポインターです。 overlayFolderPath が null の場合、packageFullName は無視され、オーバーレイ フォルダーはリセットされます (xbapp overlayfolder package_full_name /r (NDA トピック) と同等)。

戻り値

型: HRESULT 戻り値が S_OK の場合、関数は成功しています。 それ以外の値の場合は、予期しないエラーが発生したことを示します。

解説

オーバーレイ フォルダーを設定またはクリアするには、XTFSetOverlayFolder を使用します。 パッケージに現在設定されているオーバーレイ フォルダー パスを取得するには、XtfGetOverlayFolder を使用します。 本体で以前に設定されたすべてのオーバーレイ フォルダーをクリアするには、XtfClearAllOverlayFolders を使用します。 本体に現在インストールされているすべてのパッケージを列挙するには、IXtfApplicationClient::GetInstalled を使用します。
XtfSetOverlayFolder を使用して設定されたオーバーレイ フォルダーは、本体の再起動後も維持されます。

C++ の例

要件

ヘッダー: xtfapi.h ライブラリ: XtfApi.lib サポートされているプラットフォーム: Windows (XBOX 本体ツール用)

関連項目

オーバーレイ フォルダーを使用したデバッグ (NDA トピック)
コマンドライン ツール xbapp overlayfolder (NDA トピック)
XTF トランスポート エラー (NDA トピック)
最終更新日 2026年8月24日