GetStagedPackagePathByFullName2 函数 (appmodel.h)

  • 项目

获取指定暂行包的路径，其中包含 用于指定要为包检索的文件夹路径类型的选项。

语法

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

参数

packageFullName

类型： PCWSTR

暂暂包的全名。

packagePathType

类型： PackagePathType

指示要检索包 (原始安装文件夹或可变文件夹) 的文件夹路径的类型。

pathLength

类型： UINT32*

指向包含包路径字符串中 WCHAR) 字符数 (的变量的指针，其中包含 null 终止符。

首先，将 NULL 传递给 路径 以获取字符数。 使用此数字为 路径分配内存空间。 然后传递此内存空间的地址以填充 路径。

path

类型： PWSTR

指向接收包路径字符串（包括 null 终止符）的内存空间的指针。

返回值

类型： LONG

如果函数成功，则返回 ERROR_SUCCESS。 否则，函数将返回错误代码。 可能的错误代码包括以下内容。

返回代码 说明
ERROR_INSUFFICIENT_BUFFER
 path 指定的缓冲区不够大，无法容纳数据。 所需大小由 pathLength 指定。

注解

packagePathType 参数对于在其包清单中使用 windows.mutablePackageDirectories 扩展的应用程序非常有用。 此扩展指定 %ProgramFiles%\ModifiableWindowsApps 路径下的文件夹，其中投影应用程序安装文件夹的内容，以便用户可以修改安装文件。 此功能目前仅适用于 Microsoft 和我们的合作伙伴发布的某些类型的桌面电脑游戏，并且它使这些类型的游戏支持模块。

要求

要求 值
最低受支持的客户端 Windows 10 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 appmodel.h
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

GetStagedPackagePathByFullName