Skip to main content

XGameSaveEnumerateContainerInfoByName

Recupera la información de contenedores de un XGameSaveProvider. Si se proporciona un prefijo, la función devolverá únicamente los nombres que tengan ese mismo prefijo.

Sintaxis

Parámetros

provider   _In_
Tipo: XGameSaveProviderHandle
XGameSaveProvider que contiene la información de XGameSaveContainerInfo. containerNamePrefix   _In_opt_z_
Tipo: char*
Prefijo que se usará para buscar en la lista de contenedores los nombres de contenedor coincidentes. context   _In_opt_
Tipo: void*
Puntero que se pasará a la función de devolución de llamada. callback   _In_
Tipo: XGameSaveContainerInfoCallback*
La función de devolución de llamada que se ejecutará para cada contenedor que coincida con el prefijo; devuelva false para detener la enumeración. Use esta función para recopilar la información de XGameSaveContainerInfo.

Valor devuelto

Tipo: HRESULT Resultado de la función.

Comentarios

Use esta función para inspeccionar qué contenedores están disponibles para un usuario. Esto puede incluir datos que se necesitan mostrar en la experiencia de usuario. Enumerar este conjunto no provocará una sincronización en un proveedor SyncOnDemand y permitirá al autor de la llamada inspeccionar realmente el estado de sincronización mediante el campo needsSync de XGameSaveContainerInfo. Cualquier lectura de datos de blobs o uso de un contexto de actualización en un contenedor que tenga needsSync establecido en true forzará una sincronización y podría devolver varios errores de sincronización. Puede usar XGameSaveEnumerateContainerInfo si no necesita especificar un prefijo para los contenedores enumerados. XGameSaveEnumerateContainerInfo devolverá la lista completa de contenedores disponibles.

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
XGameSaveEnumerateContainerInfo
Depuración de partidas guardadas
Última modificación el 28 de agosto de 2026