Skip to main content

XGameSaveGetContainerInfo

Recupera información de los contenedores de un XGameSaveProvider.

Sintaxis

Parámetros

provider   _In_
Tipo: XGameSaveProviderHandle
Identificador de XGameSaveProvider con el contenedor deseado. containerName   _In_z_
Tipo: char*
Nombre del contenedor del que se va a recuperar información; devolverá un solo resultado si se encuentra. Si desea más de un contenedor, use XGameSaveEnumerateContainerInfo o XGameSaveEnumerateContainerInfoByName. context   _In_opt_
Tipo: void*
Puntero al objeto que realiza la llamada, para el contexto. callback   _In_
Tipo: XGameSaveContainerInfoCallback*
Función de devolución de llamada para determinar los resultados de la llamada a XGameSaveContainerInfo y recopilar sus datos.

Valor devuelto

Tipo: HRESULT Resultado de la función

Errores comunes

  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_USER_CANCELED
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

Comentarios

No es seguro llamar a esta función en un subproceso con dependencia temporal. Para obtener más información, consulte Subprocesos con dependencia temporal.
Un contenedor es una colección de metadatos y un punto de referencia para el conjunto de blobs que contiene. Si se conoce el nombre del contenedor de antemano, es posible usar esta API para devolver la información de solo ese contenedor. Esto resulta útil para recuperar información específica sobre un jugador en lugar de solicitarla toda cada vez que necesite información. Puede encontrar la composición de un XGameSaveContainer en la estructura XGameSaveContainerInfo.

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