Pular para o conteúdo principal

XtfRemoveTitleOSFromCache

Remove um Game OS do cache no console.

Sintaxe

Parâmetros

address
Tipo: PCWSTR
[in] O endereço do console. osIdentifier
Tipo: PCWSTR
[in] O identificador do sistema operacional a ser removido. Esse identificador pode ser um dos seguintes:
  • O caminho completo e o nome de um arquivo MicrosoftGame.config que contém o número de versão de quatro partes da versão do Game OS a ser removida
  • O caminho completo e o nome de um arquivo GameOs.xvd
  • O caminho completo para um diretório que contém um arquivo MicrosoftGame.config ou GameOS.vxd
  • O número de versão de quatro partes do Game OS a ser removido
Exemplos de identificadores válidos:
  • D:\MyGame
  • \MyDevPC\share\MyGame\MicrosoftGame.config
  • xd:\Titles\MyGamePFN\GameOs.xvd
  • 10.0.18236.1002

Valor retornado

Tipo: HRESULT Retorna S_OK se for bem-sucedido; caso contrário, retorna um código de erro HRESULT.

Comentários

Use essa função para gerenciar arquivos provisionados do Game OS removendo o Game OS especificado do cache no console. Se você tentar remover um Game OS sinalizado como sistema operacional de fallback, ocorrerá um erro. Se você tiver uma FourPartVersion para o Game OS que deseja remover, use a função XtfRemoveTitleOSFromCacheByVersion para remover essa versão do Game OS. Você pode usar a função XtfGetCachedTitleOSVersions para obter a FourPartVersion de cada Game OS armazenado em cache no console ou a função XtfGetTitleOSFourPartVersion para obter a FourPartVersion do Game OS do título em execução no momento. Você também pode adicionar um Game OS ao cache no console chamando a função XtfCacheTitleOS. Para obter mais informações sobre como gerenciar arquivos provisionados do Game OS, confira Gerenciamento de aplicativos (xbapp.exe) (tópico sob NDA) e Provisionamentoamento (xbprovision.exe) (tópico sob NDA).

Requisitos

Cabeçalho: xtfapi.h Biblioteca: XtfApi.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)

Confira também

Implantação de execução a partir do PC (tópico sob NDA)
Erros de transporte do XTF (tópico sob NDA)
APIs adicionais do Xtf
Última modificação em 6 de outubro de 2026