Поделиться через

Функция 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
Header appmodel.h
Библиотека Kernel32.lib
DLL Kernel32.dll