Skip to main content

XtfGetOverlayFolder

特定のパッケージのフル ネームに関連付けられたオーバーレイ フォルダー パスを取得します。

Syntax

Parameters

address
型: PCWSTR
[in] コンソールのアドレスへのポインターです。 packageFullName
型: PCWSTR
[in] アプリのパッケージのフル ネームへのポインターです。 overlayFolderPath
型: PWSTR
[out, optional] オーバーレイ フォルダー パスです。 overlayFolderPathLength
型: UINT32
[in, out] overlayFolderPath の長さ (WCHAR 単位) です。

Return value

型: HRESULT 指定されたパッケージのフル ネームに対してパスが設定されていない場合、overlayFolderPath の戻り値は null、overlayFolderPathLength は 0 (ゼロ) となり、S_OK が返されます。 成功した場合は S_OK を返します。overlayFolderPath の長さが足りない場合は HRESULT_FROM_WIN32(ERROR_MORE_DATA) を返し、必要なバッファーの長さが overlayFolderPathLength に返されます。

Remarks

オーバーレイ フォルダーの設定や解除には XTFSetOverlayFolder を使用します。パッケージに現在設定されているオーバーレイ フォルダー パスを取得するには XtfGetOverlayFolder を使用します。コンソール上で以前に設定されたすべてのオーバーレイ フォルダーをクリアするには XtfClearAllOverlayFolders を使用します。コンソールに現在インストールされているすべてのパッケージを列挙するには IXtfApplicationClient::GetInstalled を使用します。

Requirements

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

See also

XTF Transport Errors (NDA topic)
Additional Xtf APIs
Debugging with Overlay Folders (NDA topic)
コマンド ライン ツール xbapp overlayfolder (NDA topic)
最終更新日 2026年8月24日