FindPackagesByPackageFamily 函数 (appmodel.h)

查找具有当前用户的指定系列名称的包。

语法

LONG FindPackagesByPackageFamily(
  [in]            PCWSTR packageFamilyName,
  [in]            UINT32 packageFilters,
  [in, out]       UINT32 *count,
  [out, optional] PWSTR  *packageFullNames,
  [in, out]       UINT32 *bufferLength,
  [out, optional] WCHAR  *buffer,
  [out, optional] UINT32 *packageProperties
);

参数

[in] packageFamilyName

类型： PCWSTR

包系列名称。

[in] packageFilters

类型： UINT32

指定如何检索包信息的包 常量 。 支持除 PACKAGE_FILTER_ALL_LOADED 之外的所有包常量。

[in, out] count

类型： UINT32*

指向包含找到的包全名数的变量的指针。

首先，将 NULL 传递给 packageFullNames 以获取找到的包全名数。 使用此数字为 packageFullNames 分配内存空间。 然后传递此内存空间的地址以填充 packageFullNames。

[out, optional] packageFullNames

类型： PWSTR*

指向内存空间的指针，该内存空间接收找到的包全名字符串。

[in, out] bufferLength

类型： UINT32*

指向变量的指针，该变量保存包全名字符串中的字符数。

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

[out, optional] buffer

类型： WCHAR*

指向内存空间的指针，该内存空间接收所有包全名的字符串。

[out, optional] packageProperties

类型： UINT32*

指向内存空间的指针，该内存空间接收找到的所有包 的包属性 。

返回值

类型： LONG

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

返回代码	说明
ERROR_INSUFFICIENT_BUFFER	一个或多个缓冲区不够大，无法容纳数据。 所需的大小由 count 或 buffer 指定。

要求

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