XtfGetOverlayFolder
特定のパッケージ フル ネームに関連付けられているオーバーレイ フォルダーのパスを取得します。
構文
HRESULT XtfGetOverlayFolder(
PCWSTR address,
PCWSTR packageFullName,
PWSTR overlayFolderPath,
UINT32* overlayFolderPathLength
)
パラメーター
address
型: PCWSTR
[in] 本体のアドレスへのポインター。
packageFullName
型: PCWSTR
[in] アプリのパッケージのフル ネームへのポインター。
overlayFolderPath
型: PWSTR
[out, optional] オーバーレイのフォルダー パス。
overlayFolderPathLength
型: UINT32
[in, out] WCHAR の overlayFolderPath の長さ。
戻り値
型: HRESULT
指定されたパッケージ完全名にパスが設定されていない場合、overlayFolderPath で返される値は null、overlayFolderPathLength はゼロ (0)、そして S_OK が返されます。
成功すると、S_OK が返されます。 overlayFolderPath が十分な長さではない場合に HRESULT_FROM_WIN32(ERROR_MORE_DATA) を返し、必要なバッファーの長さが overlayFolderPathLength で返されます。
解説
XTFSetOverlayFolder を使用して、オーバーレイ フォルダを設定またはクリアします。 XtfGetOverlayFolder を使用して、パッケージに現在設定されているオーバーレイ フォルダのパスを取得します。 XtfClearAllOverlayFolders を使用して、本体に以前設定されたすべてのオーバーレイ フォルダをクリアします。 IXtfApplicationClient::GetInstalled を使用して、本体に現在インストールされているパッケージを列挙します。
要件
ヘッダー: xtfapi.h
ライブラリ: XtfApi.lib
サポートされているプラットフォーム: Windows (Xbox 本体ツール用)
関連項目
XTF トランスポート エラー (NDA トピック)認可が必須です
その他の Xtf API
オーバーレイ フォルダーを使用したデバッグ (NDA トピック)認可が必須です
コマンド ライン ツール xbapp overlayfolder (NDA トピック)認可が必須です