XGameSaveCloseProvider

释放 XGameSaveProvider 持有的资源。

语法

void XGameSaveCloseProvider(  
         XGameSaveProviderHandle provider  
)  

参数

provider _In_
类型:XGameSaveProviderHandle

要关闭的 XGameSaveProvider 句柄。

返回值

类型:void

备注

注意

在时间敏感线程上调用此函数是不安全的。 有关详细信息,请参阅时间敏感线程

每个提供程序都会持有在不再需要时或者现有提供程序变得失效时需要清除的资源。 一个提供程序可能会出于若干原因变得失效,一个主要原因就是在应用程序挂起时同一用户在不同设备上盗用了上下文。 这表示为 E_GS_HANDLE_EXPIRED 并且可从任何 XGameSave API 返回,正确的处理方式是关闭该提供程序,然后重新初始化并且提示用户处理任何可能的冲突问题。

XGameSaveProviderHandle _provider; 
 
void Sample::_Uninitialize() 
{ 
    if (_provider) 
    { 
        XGameSaveCloseProvider(_provider); 
        _provider = nullptr; 
    } 
} 

要求

头文件:XGameSave.h

库:xgameruntime.lib

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XGameSave
XGameSaveInitializeProvider
XGameSaveInitializeProviderAsync
游戏保存错误