Функция GetPackagesByPackageFamily (appmodel.h)

Статья
02/28/2024

Возвращает пакеты с указанным именем семейства для текущего пользователя.

Синтаксис

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

См. также

PackageNameAndPublisherIdFromFamilyName

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