Skip to main content

XPersistentLocalStorageMountForPackage

Monta o armazenamento local persistente (PLS) do pacote especificado como um disco somente leitura.

Sintaxe

Parâmetros

packageIdentifier   _In_
Tipo: char*
Uma cadeia de caracteres que identifica exclusivamente o pacote da loja ao qual o PLS pertence. Para obter mais informações sobre identificadores de pacote, consulte Gerenciar e licenciar conteúdo para download (DLC). mountHandle   _Out_writes_to_(pathSize,pathUsed)
Tipo: XPackageMountHandle
O identificador de montagem do disco em que o PLS foi montado.

Valor retornado

Tipo: HRESULT Retorna S_OK se for bem-sucedida; caso contrário, retorna um código de erro. Para obter uma lista de códigos de erro, consulte Códigos de erro. Se a função falhar porque o PLS do título especificado não existe, o valor será definido como FILE_NOT_FOUND. Se a função falhar porque tenta acessar o PLS de um título que não habilitou o armazenamento local persistente compartilhável, ela receberá ACCESS_DENIED.

Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
Para que um título dê suporte ao PLS compartilhável, ele precisa declarar isso no MicrosoftGame.config. Mais detalhes sobre o Armazenamento Local Persistente Compartilhável podem ser encontrados em Armazenamento local
Se um título marcar o PLS como compartilhável, ele deverá garantir que, antes de suspender o jogo, feche todos os identificadores do seu PLS; caso contrário, a suspensão do jogo falhará e o jogo será encerrado.
O snippet de código a seguir mostra um exemplo de acesso ao PLS compartilhável de outro título.

Requisitos

Cabeçalho: XPersistentLocalStorage.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XPersistentLocalStorage
Como usar o novo arquivo MicrosoftGame.config
Armazenamento local
Last modified on October 6, 2026