GetStagedPackagePathByFullName2 函式 (appmodel.h)

  • 發行項

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

語法

LONG GetStagedPackagePathByFullName2(
  PCWSTR          packageFullName,
  PackagePathType packagePathType,
  UINT32          *pathLength,
  PWSTR           path
);

參數

packageFullName

類型： PCWSTR

暫存套件的完整名稱。

packagePathType

類型： PackagePathType

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

pathLength

類型： UINT32*

變數的指標，其中包含 null 終止符 (套件路徑字串中的 WCHARs) 字元數。

首先，您會將 NULL 傳遞至 路徑 ，以取得字元數。 您可以使用這個數位來設定 路徑的記憶體空間。 然後，您傳遞此記憶體空間的位址以填滿 路徑。

path

類型： PWSTR

接收封裝路徑字串的記憶體空間指標，其中包含 null 終止符。

傳回值

類型： LONG

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

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

備註

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

規格需求

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

另請參閱

GetStagedPackagePathByFullName