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

Monte le stockage local persistant (PLS) du package spécifié en tant que disque en lecture seule.

## Syntaxe

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

### Paramètres

*packageIdentifier*   \_In\_\
Type : char\*

Une chaîne qui identifie de façon unique le package du Store auquel appartient le PLS. Pour plus d'informations sur les identificateurs de package, consultez [Gérer et octroyer des licences pour le contenu téléchargeable (DLC)](/fr-CA/publishing/xstore-commerce/xstore-dlc).

*mountHandle*   \_Out\_writes\_to\_(pathSize,*pathUsed)\
Type : XPackageMountHandle*

Le handle de montage du disque sur lequel le PLS a été monté.

### Valeur de retour

Type : [HRESULT](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

Retourne **S\_OK** en cas de réussite; sinon, retourne un code d'erreur. Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](/fr-CA/reference/errorcodes). Si la fonction échoue parce que le PLS du titre spécifié n'existe pas, la valeur sera **FILE\_NOT\_FOUND**. Si la fonction échoue parce qu'elle tente d'accéder au PLS d'un titre qui n'a pas activé le stockage local persistant partageable, elle obtiendra **ACCESS\_DENIED**.

## Remarques

<Note>Il n'est pas sécuritaire d'appeler cette fonction sur un thread sensible au temps. Pour plus d'informations, consultez [Threads sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Pour qu'un titre prenne en charge le PLS partageable, il doit le déclarer dans MicrosoftGame.config. Vous trouverez plus de détails sur le stockage local persistant partageable dans [Stockage local](/fr-CA/build/console-features/storage/local-storage)

<Note>Si un titre marque son PLS comme partageable, il doit s'assurer de fermer tous les handles vers son PLS avant la suspension du jeu; sinon, la suspension du jeu échouera et le jeu sera arrêté.</Note>

L'extrait de code suivant montre un exemple d'accès au PLS partageable d'un autre titre.

```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; 
} 

```

## Configuration requise

**En-tête :** XPersistentLocalStorage.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Threads sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[XPersistentLocalStorage](/fr-CA/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members)\
[Comment utiliser le nouveau fichier MicrosoftGame.config](/fr-CA/build/core-features/common/game-config/MicrosoftGameConfig-toc)\
[Stockage local](/fr-CA/build/console-features/storage/local-storage)


## Related topics

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