GetPackagesByPackageFamily 函数 (appmodel.h)

获取具有当前用户的指定系列名称的包。

语法

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

参数

[in] packageFamilyName

类型： PCWSTR

包系列名称。

[in, out] count

类型： UINT32*

指向保存包全名数的变量的指针。

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

[out, optional] packageFullNames

类型： PWSTR*

指向包全名字符串的指针。

[in, out] bufferLength

类型： UINT32*

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

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

[out, optional] buffer

类型： WCHAR*

所有包全名的字符串。

返回值

类型： LONG

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

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

要求

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

另请参阅

PackageNameAndPublisherIdFromFamilyName