Skip to main content

XPersistentLocalStorageGetPathSize

Retorna o comprimento, em caracteres, do caminho para o armazenamento local persistente (PLS).

Sintaxe

Parâmetros

pathSize   _Out_
Tipo: size_t*
O comprimento, em caracteres, do caminho do PLS.

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.

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.
O valor retornado por esta função é usado no parâmetro pathSize da função XPersistentLocalStorageGetPath para retornar o caminho do PLS específico do jogo no dispositivo. Para obter mais informações sobre o PLS, consulte Armazenamento local. Ao chamar a função XPersistentLocalStorageGetPath, aloque para o parâmetro path de XPersistentLocalStorageGetPath pelo menos a quantidade de caracteres especificada no valor retornado no parâmetro pathSize desta função; caso contrário, ocorrerá um erro. O exemplo a seguir ilustra como usar as funções XPersistentLocalStorageGetPathSize e XPersistentLocalStorageGetPath para obter o caminho do PLS para o seu jogo.

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

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