> ## 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 el almacenamiento local persistente (PLS) del paquete especificado como un disco de solo lectura.

## Sintaxis

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

### Parámetros

*packageIdentifier*   \_In\_\
Tipo: char\*

Una cadena que identifica de forma única el paquete de la tienda al que pertenece el PLS. Para obtener más información sobre los identificadores de paquetes, consulte [Administración y licencias de contenido descargable (DLC)](/publishing/xstore-commerce/xstore-dlc).

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

El identificador de montaje del disco donde se montó el PLS.

### Valor devuelto

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

Devuelve **S\_OK** si se realiza correctamente; de lo contrario, devuelve un código de error. Para obtener una lista de códigos de error, consulte [Códigos de error](/reference/errorcodes). Si la función produce un error porque el PLS del título especificado no existe, se establecerá en **FILE\_NOT\_FOUND**. Si la función produce un error porque intenta acceder al PLS de un título que no ha habilitado el almacenamiento local persistente compartible, obtendrá **ACCESS\_DENIED**.

## Comentarios

<Note>No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Para que un título admita el PLS compartible, debe declararlo como tal en MicrosoftGame.config. Puede encontrar más detalles sobre el almacenamiento local persistente compartible en [Almacenamiento local](/build/console-features/storage/local-storage)

<Note>Si un título marca el PLS como compartible, debe asegurarse de que, antes de suspender el juego, cierre todos los identificadores de su PLS; de lo contrario, la suspensión del juego producirá un error y el juego se finalizará.</Note>

El fragmento de código siguiente muestra un ejemplo de acceso al PLS compartible de otro 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

**Encabezado:** XPersistentLocalStorage.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Consulte también

[XPersistentLocalStorage](/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members)\
[Cómo usar el nuevo archivo MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-toc)\
[Almacenamiento local](/build/console-features/storage/local-storage)


## Related topics

- [XPersistentLocalStorage](/es/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md)
- [XPersistentLocalStorageSpaceInfo](/es/reference/system/xpersistentlocalstorage/structs/xpersistentlocalstoragespaceinfo.md)
- [XPersistentLocalStorageGetPath](/es/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetpath.md)
- [XPersistentLocalStorageGetSpaceInfo](/es/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetspaceinfo.md)
- [XPersistentLocalStorageGetPathSize](/es/reference/system/xpersistentlocalstorage/functions/xpersistentlocalstoragegetpathsize.md)