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。 否则,该函数将返回错误代码。 可能的错误代码包括以下内容。
返回代码 | 说明 |
---|---|
|
一个或多个缓冲区不够大,无法容纳数据。 所需的大小由 count 或 buffer 指定。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | Windows |
标头 | appmodel.h |
Library | Kernel32.lib |
DLL | Kernel32.dll |