GetPackageInfo2 函式 (appmodel.h)

發行項
02/23/2024

取得指定封裝的封裝資訊，以及指定要針對封裝擷取之資料夾路徑類型的選項。

語法

LONG GetPackageInfo2(
  PACKAGE_INFO_REFERENCE packageInfoReference,
  const UINT32           flags,
  PackagePathType        packagePathType,
  UINT32                 *bufferLength,
  BYTE                   *buffer,
  UINT32                 *count
);

參數

packageInfoReference

類型： PACKAGE_INFO_REFERENCE

封裝信息的參考。

flags

類型： const UINT32

指定如何擷取封裝資訊的封裝常數。

packagePathType

類型： PackagePathType

指出要針對套件擷取的資料夾路徑類型， (原始安裝資料夾或可變資料夾) 。

bufferLength

類型： UINT32*

在輸入時， 緩衝區的大小，以位元組為單位。輸出時，傳回的封裝資訊大小，以位元組為單位。

buffer

類型： BYTE*

封裝資訊，以 PACKAGE_INFO 結構的陣列表示。

count

類型： UINT32*

緩衝區中的封裝數目。

傳回值

類型： LONG

如果函式成功，它會傳回 ERROR_SUCCESS。否則，函式會傳回錯誤碼。可能的錯誤碼包括下列各項。

傳回碼	Description
ERROR_INSUFFICIENT_BUFFER	緩衝區不夠大，無法保存數據。必要大小是由 bufferLength 指定。

備註

packagePathType 參數適用於在其套件指令清單中使用 windows.mutablePackageDirectories 擴充功能的應用程式。此延伸模組會指定 %ProgramFiles%\ModifiableWindowsApps 路徑下的資料夾，其中投影應用程式安裝資料夾的內容，讓使用者可以修改安裝檔案。這項功能目前僅適用於 Microsoft 和我們的合作夥伴所發行的特定傳統型電腦遊戲類型，並可讓這些類型的遊戲支援模式。

規格需求

需求	值
最低支援的用戶端	Windows 10 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2016 [僅限傳統型應用程式]
目標平台	Windows
標頭	appmodel.h
程式庫	Kernel32.lib
DLL	Kernel32.dll