次の方法で共有

XtfRemoveTitleOSFromCache

  • [アーティクル]

本体のキャッシュからゲーム OS を削除します。

構文

HRESULT XtfRemoveTitleOSFromCache(
         PCWSTR address,
         PCWSTR osIdentifier
)

パラメーター

address
型: PCWSTR

[in] 本体のアドレス。

osIdentifier
型: PCWSTR

[in] 削除する OS の識別子。 この識別子は次のいずれかになります。

  • 削除するゲーム OS バージョンの 4 つの部分から成るバージョン番号を含む MicrosoftGame.config ファイルの完全パスとファイル名。
  • GameOs.xvd ファイルの完全パスとファイル名。
  • ファイル MicrosoftGame.config または GameOS.vxd file が保存されているディレクトリの完全パス。
  • 削除するゲーム OS の 4 つの部分から成るバージョン番号。

有効な識別子の例:

  • D:\MyGame
  • \MyDevPC\share\MyGame\MicrosoftGame.config
  • xd:\Titles\MyGamePFN\GameOs.xvd
  • 10.0.18236.1002

戻り値

型: HRESULT

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

解説

この関数を使用して、プロビジョニングされたゲーム OS ファイルを管理します。この場合、指定されたゲーム OS を本体のキャッシュから削除します。 フォールバック OS としてフラグが設定されているゲームを削除しようとすると、エラーが発生します。

削除するゲーム OS の FourPartVersion を使用している場合、そのゲーム OS バージョンを削除するのではなく、XtfRemoveTitleOSFromCacheByVersion 関数を使用します。 XtfGetCachedTitleOSVersions 関数を使用して、本体にキャッシュされている各ゲーム OS の FourPartVersion を取得できます。または、XtfGetTitleOSFourPartVersion 関数を使用して、現在実行中のタイトルのゲーム OS の FourPartVersion を取得できます。

また、XtfCacheTitleOS 関数を呼び出すことによって、本体のキャッシュにゲーム OS を追加できます。 プロビジョニングされたゲーム OS ファイルの管理の詳細については、「アプリケーション管理 (xbapp.exe) (NDA トピック)」および「プロビジョニング (xbprovision.exe) (NDA トピック)」を参照してください。

要件

ヘッダー: xtfapi.h

ライブラリ: XtfApi.lib

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

関連項目

PC 展開から実行する (NDA トピック)
XTF トランスポート エラー (NDA トピック)
その他の Xtf API