跳轉到主要內容

XtfGetAumid

從套件資訊物件取得位於指定索引處的應用程式使用者模型識別碼 (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
最後修改於 2026年10月6日