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。通过调用 XtfRegisterPackage 或 XtfRegisterNetworkSharePackage 函数注册包时,会返回指向包信息对象的指针。
在调用此函数之前,请使用 XtfGetcountofAppUserModelIds 函数获取包中 AUMID 的数量。如果在 aumidIndex 中指定的值等于或大于 XtfGetcountofAppUserModelIds 返回的值,则会发生错误。同样,如果在 aumidIndex 指定的索引处没有可检索的数据,也会发生错误。
你还可以使用 XtfGetPackageFullName 函数检索已注册包的完整名称。有关包的更多信息,请参阅 打包。
要求
头文件: xtfapi.h 库: XtfApi.lib 支持的平台: Windows(用于 XBOX 主机工具)另请参阅
XTF 传输错误 (NDA 主题)XtfRegisterPackage
XtfRegisterNetworkSharePackage
其他 Xtf API
