> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XPackageEnumerationCallback

> XPackageEnumerationCallback

# XPackageEnumerationCallback

由 [XPackageEnumeratePackages](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageenumeratepackages.md) 用于枚举每个程序包的回调。

## 语法

```cpp theme={null}
bool XPackageEnumerationCallback(  
         void* context,  
         const XPackageDetails* details  
)  
```

### 参数

*context*   \_In\_\
类型：void\*

在启动程序包枚举时传递给 [XPackageEnumeratePackages](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageenumeratepackages.md) 的上下文。

*details*   \_In\_\
类型：[XPackageDetails](https://docs.xbox.com/zh-CN/reference/system/xpackage/structs/xpackagedetails.md)\*

指向 [XPackageDetails](https://docs.xbox.com/zh-CN/reference/system/xpackage/structs/xpackagedetails.md) 结构的指针，其中包含枚举中当前程序包的安装信息。

### 返回值

类型：bool

返回 true 以继续枚举程序包，返回 false 以停止枚举。

## 备注

**XPackageEnumerationCallback** 回调在 [XPackageEnumeratePackages](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageenumeratepackages.md) 枚举过程中对每个程序包调用。

[XPackageEnumeratePackages](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageenumeratepackages.md) 和 [XPackageRegisterPackageInstalled](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md) 都通过 [XPackageDetails](https://docs.xbox.com/zh-CN/reference/system/xpackage/structs/xpackagedetails.md) 结构提供有关安装的详细信息。如果程序包正在安装，则 **XPackageDetails** 的 **installing** 属性为 **true**，你可以创建安装监视器，让程序包的标识符监视进度。

没有通用的安装队列通知；其意图是使用 [XPackageEnumeratePackages](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageenumeratepackages.md) 来显示和跟踪正在进行的项，并使用 [XPackageRegisterPackageInstalled](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md) 宣告新 DLC 的存在。也没有启动、停止或取消安装的机制。从游戏的角度来看，安装应该自动进行。错误会自动重试，对游戏不可见。

示例：

```cpp theme={null}
bool CALLBACK ListDlcCallback(
    void* /* context */,
    const XPackageDetails* details)
{
    printf("Found dlc: %s\n", details->displayName);
    return true; // continue enumerating
}

HRESULT ListDlc()
{
    HRESULT hr = XPackageEnumeratePackages(
        XPackageKind::Content,                      /* Looking for content packages (DLC) */
        XPackageEnumerationScope::ThisAndRelated,   /* For this game and related games*/
        nullptr, ListDlcCallback);
    return hr;
}
```

## 要求

**头文件：** XPackage.h

**库：** xgameruntime.lib

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

## 概念性文档

* [管理和许可可下载内容 (DLC)](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-dlc.md)

## 另请参阅

[XPackage](https://docs.xbox.com/zh-CN/reference/system/xpackage/xpackage_members.md)\
[如何为 PC 和 XBOX One 创建和使用可下载内容程序包 (DLC)](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/packaging-downloadable-content-dlc.md)\
[XPackageDetails](https://docs.xbox.com/zh-CN/reference/system/xpackage/structs/xpackagedetails.md)\
[XPackageEnumeratePackages](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageenumeratepackages.md)\
[XPackageRegisterPackageInstalled](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md)


## Related topics

- [XPackageEnumeratePackages](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackageenumeratepackages.md)
- [XPackageMountWithUiAsync](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagemountwithuiasync.md)
- [管理并授权可下载内容 (DLC)](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-dlc.md)
- [XPackage（API 内容）](https://docs.xbox.com/zh-CN/reference/system/xpackage/xpackage_members.md)
- [XPackageFeatureEnumerationCallback](https://docs.xbox.com/zh-CN/reference/system/xpackage/functions/xpackagefeatureenumerationcallback.md)