Skip to main content

XGameSaveInitializeProviderAsync

Proporciona e inicializa de forma asincrónica un identificador de proveedor de XGameSave.

Sintaxis

Parámetros

requestingUser   _In_
Tipo: XUserHandle
Identificador de un usuario de XBOX Live. configurationId   _In_z_
Tipo: char*
Identificador de configuración de servicio (SCID). syncOnDemand   _In_
Tipo: bool
Cuando es true, syncOnDemand solo descarga datos del servicio si es necesario. No funciona si el dispositivo está sin conexión. Establecerlo en true puede hacer que se muestre la interfaz de usuario de progreso de sincronización. async   _In_
Tipo: XAsyncBlock*
Contiene la información de la llamada asincrónica. Esto incluye el contexto de llamada y una llamada a la función XGameSaveInitializeProviderResult.

Valor devuelto

Tipo: HRESULT Resultado de la función.

Comentarios

Se debe llamar correctamente a esta función antes de usar otras API de XGameSave.
La API XGameSave requiere que el título tenga su identificador de título y su identificador de configuración de servicio (SCID)
configurados correctamente para funcionar. Para obtener más información sobre estos identificadores necesarios, consulte Configuración de sandboxes para el desarrollo de XBOX Live. El juego debe estar habilitado para XBOX Live en Partner Center.
Si no configura correctamente el SCID y el identificador de título, las llamadas a la API XSaveGame producirán el siguiente código de error: E_GS_NO_ACCESS - 0x80830002 - Error en la operación porque el título no tiene acceso a los espacios de almacenamiento de contenedores. El XGameSaveProviderHandle resultante se obtiene de la función XGameSaveInitializeProviderResult. Este es el identificador que usará para acceder a su XGameSaveProvider. Cuando se llama a esta API con syncOnDemand establecido en true, se comporta igual desde la perspectiva del autor de la llamada, pero provoca algunas diferencias de comportamiento en el resto de la API. El XGameSaveProvider con SyncOnDemand solo descargará datos del servicio si es necesario, pero esto también tiene el inconveniente de que cualquier operación de contenedor puede retrasarse en este caso, y este retraso puede hacer que se muestre alguna experiencia de usuario para indicar el progreso de la sincronización. El uso de cualquiera de los métodos siguientes puede forzar una sincronización: Otro inconveniente sería que, si el dispositivo está sin conexión o tiene problemas de conectividad, el acceso al contenedor es imposible. ##Ejemplo
Los juegos no pueden combinar el uso de XGameSaveFiles con el uso de XGameSave. Los juegos deben elegir qué sistema de guardado en la nube quieren usar. Si el juego usa XGameSaveFiles y más adelante llama a XGameSaveInitializeProvider, se producirá un error E_GS_PROVIDER_MISMATCH. Del mismo modo, si el juego usaba XGameSave y más adelante llama a XGameSaveFilesGetFolderWithUiAsync, también se producirá un error E_GS_PROVIDER_MISMATCH.

Requisitos

Encabezado: XGameSave.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XGameSave
XGameSaveInitializeProviderResult
XGameSaveInitializeProvider
Depuración de partidas guardadas
Última modificación el 28 de agosto de 2026