Skip to main content

XtfGetAumid

从包信息对象中获取指定索引处的应用程序用户模型 ID (AUMID)。

语法

参数

packageInfo
类型:XtfPackageInfo
[in] 指向包信息对象的指针。 aumidIndex
类型:UINT32
[in] 包中 AUMID 的索引。 aumid
类型:PWSTR
[out, optional] 包中在 aumidIndex 指定的索引处的 AUMID。 aumidBufferLength
类型:UINT32 *
[in, out] 为 aumid 分配的长度,以 WCHAR 为单位。

返回值

类型:HRESULT 成功时返回 S_OK。如果 aumid 空间不够,此函数将返回 HRESULT_FROM_WIN32(ERROR_MORE_DATA),并在 aumidBufferLength 中返回所需的缓冲区长度。

备注

使用此函数从已注册包的信息对象中获取 aumidIndex 指定索引处的 AUMID。通过调用 XtfRegisterPackageXtfRegisterNetworkSharePackage 函数注册包时,会返回指向包信息对象的指针。 在调用此函数之前,请使用 XtfGetcountofAppUserModelIds 函数获取包中 AUMID 的数量。如果在 aumidIndex 中指定的值等于或大于 XtfGetcountofAppUserModelIds 返回的值,则会发生错误。同样,如果在 aumidIndex 指定的索引处没有可检索的数据,也会发生错误。 你还可以使用 XtfGetPackageFullName 函数检索已注册包的完整名称。有关包的更多信息,请参阅 打包

要求

头文件: xtfapi.h 库: XtfApi.lib 支持的平台: Windows(用于 XBOX 主机工具)

另请参阅

XTF 传输错误 (NDA 主题)
XtfRegisterPackage
XtfRegisterNetworkSharePackage
其他 Xtf API
最后修改于 2026年8月24日