> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XPersistentLocalStorageMountForPackage

> XPersistentLocalStorageMountForPackage

# XPersistentLocalStorageMountForPackage

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

## Sintaxe

```cpp theme={null}
HRESULT XPersistentLocalStorageMountForPackage (   
         const char* packageIdentifier,   
         XPackageMountHandle* mountHandle 
) 
```

### 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)](/pt-BR/publishing/xstore-commerce/xstore-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](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

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](/pt-BR/reference/errorcodes). 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

<Note>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](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

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](/pt-BR/build/console-features/storage/local-storage)

<Note>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.</Note>

O snippet de código a seguir mostra um exemplo de acesso ao PLS compartilhável de outro título.

```cpp theme={null}

HRESULT MountPersistentLocalStorageForPackage(char* packageIdentifier) 
{      
    XPackageMountHandle* mountHandle; 
    HRESULT hr = XPersistentLocalStorageMountForPackage (packageIdentifier, &mountHandle); 

    if (FAILED(hr)) return hr; 
    size_t pathSize; 
    hr = XGetMountPathSize(mountHandle, &pathSize); 
    if (FAILED(hr)) 
    { 
        XPackageCloseMountHandle(mountHandle); 
        return hr; 
    } 
 
    char* path = new (std::nothrow) char[pathSize]; 



    if (path == nullptr) 
    { 
        XPackageCloseMountHandle (mountHandle); 
        return E_OUTOFMEMORY; 
    } 
 
    hr = XPackageGetMountPath (mountHandle, pathSize, path); 
    if (FAILED(hr)) 
    { 
        XPackageCloseMountHandle(mountHandle); 
        delete[] path; 
        return hr; 
    } 
 
    printf("PLS %s mounted at path %s\n", packageIdentifier, path); 
    delete[] path; 
 
    // Unmounts PLS path if this is the last handle 
    // to it. 
    XPackageCloseMountHandle(mountHandle); 
    return S_OK; 
} 

```

## 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

* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também




[XPersistentLocalStorage](/pt-BR/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members)\
[Como usar o novo arquivo MicrosoftGame.config](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-toc)\
[Armazenamento local](/pt-BR/build/console-features/storage/local-storage)


## Related topics

- [XPersistentLocalStorageMountForPackage](/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragemountforpackage.md)
- [XPersistentLocalStorage](/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md)