> ## 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.

# XPackageUninstallPackage

> XPackageUninstallPackage

# XPackageUninstallPackage

卸载给定的包。

## 语法

```cpp theme={null}

bool XPackageUninstallPackage(
    const char* packageIdentifier) 
noexcept;
```

### 参数

*packageIdentifier*   \_In\_z\_\
类型：char\*

用于在磁盘上唯一标识已安装包的字符串。有关包标识符的详细信息，请参阅[管理和授权可下载内容 (DLC)](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-manage-and-license-optional-packages)。

### 返回值

类型：bool

Bool 用于指示包是否已成功卸载。

## 备注

<Note>此函数在时间敏感型线程上调用不安全。有关详细信息，请参阅[时间敏感型线程](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。</Note>

**XPackageUninstallPackage** 卸载给定的包。所提供的包标识符将从 **XPackageEnumeratePackages** 或其他返回包标识符的 API 中返回。如果包已被卸载，**XPackageUninstallPackage** 将返回 true；如果无法卸载包，则返回 false。

包卸载失败的原因包括：

* 包正在使用中。例如，它是游戏当前已装载的 DLC 包。
* 游戏正在 xCloud 服务器上运行。包的安装和删除由服务器环境负责。

在以下示例中，**XPackageUninstallPackage** 用于卸载包以为用户释放磁盘空间。

```cpp theme={null}
bool UninstallDlcToReclaimDiskSpace(const char_t* packageIdentifier) 
{
return XPackageUninstallPackage(packageIdentifier);
} 
```

## 要求

**头文件：** XPackage.h

**库：** xgameruntime.lib

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 概念文档

* [管理和授权可下载内容 (DLC)](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-manage-and-license-optional-packages)

## 另请参阅

[XPackage](/reference/system/xpackage/xpackage_members)\
[流式安装和智能交付](/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery)


## Related topics

- [管理并授权可下载内容 (DLC)](/zh-CN/publishing/xstore-commerce/xstore-dlc.md)
- [XPackage](/zh-CN/reference/system/xpackage/xpackage_members.md)
- [XPackageUninstallChunks](/zh-CN/reference/system/xpackage/functions/xpackageuninstallchunks.md)
- [XPackageUninstallUWPInstance](/zh-CN/reference/system/xpackage/functions/xpackageuninstalluwpinstance.md)
- [IXtfApplicationClient::Uninstall](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/uninstall-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)