通过

XtfGetAumid

  • 项目

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

语法

HRESULT XtfGetAumid(
         XtfPackageInfo packageInfo,
         UINT32 aumidIndex,
         PWSTR aumid,
         UINT32 *aumidBufferLength
)

参数

packageInfo
类型：XtfPackageInfo

[in] 指向包的信息对象的指针。

aumidIndex
类型：UINT32

[in] 包中 AUMID 的索引。

aumid
类型：PWSTR

[out，可选]在 中为包指定的 aumidIndex 索引处的 AUMID。

aumidBufferLength
类型：UINT32 *

[in，out]为 分配的长度（以 WCHAR 为单位 aumid）。

返回值

类型：HRESULT

如果成功，返回 S_OK。 如果 aumid 不够大，此函数则返回 HRESULT_FROM_WIN32(ERROR_MORE_DATA)，并且所需的缓冲区长度会在 aumidBufferLength 中返回。

备注

使用此函数可从已注册包的信息对象中获取在 aumidIndex 中指定的索引处的 AUMID。 一个指针，该指针指向通过调用 XtfRegisterPackage 或 XtfRegisterNetworkSharePackage 函数来注册包而返回的包信息对象。

调用此函数前，请使用 XtfGetcountofAppUserModelIds 函数获取包的 AUMID 计数。 如果在 aumidIndex 中指定的值大于或等于 XtfGetcountofAppUserModelIds 返回的值，则会出现错误。 同样，如果在 aumidIndex 中指定的索引处没有要检索的数据，则会出现错误。

还可以使用 XtfGetPackageFullName 函数检索已注册包的完整名称。 有关包的详细信息，请参阅打包。

要求

头文件：xtfapi.h

库：XtfApi.lib

支持平台：Windows（适用于 Xbox 主机工具）

另请参阅

XTF 传输错误（NDA 主题）
XtfRegisterPackage
XtfRegisterNetworkSharePackage
其他 Xtf API