GetCurrentPackagePath2 函式 (appmodel.h)

發行項
02/23/2024

取得呼叫進程的封裝路徑，以及指定要為封裝擷取之資料夾路徑類型的選項。

語法

LONG GetCurrentPackagePath2(
  PackagePathType packagePathType,
  UINT32          *pathLength,
  PWSTR           path
);

參數

packagePathType

類型： PackagePathType

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

pathLength

類型： UINT32*

在輸入時，路徑緩衝區的大小，以字元為單位。輸出時，傳回的封裝路徑大小，以字元為單位，包括 Null 終止符。

path

類型： PWSTR

封裝路徑。

傳回值

類型： LONG

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

傳回碼	Description
APPMODEL_ERROR_NO_PACKAGE	進程沒有套件身分識別。
ERROR_INSUFFICIENT_BUFFER	緩衝區不夠大，無法保存數據。必要的大小是由 pathLength 指定。

備註

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

規格需求

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