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


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

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

Синтаксис

LONG GetPackagePathByFullName2(
  PCWSTR          packageFullName,
  PackagePathType packagePathType,
  UINT32          *pathLength,
  PWSTR           path
);

Параметры

packageFullName

Тип: PCWSTR

Полное имя пакета.

packagePathType

Тип: PackagePathType

Указывает тип пути к папке, извлекаемой для пакета (исходная папка установки или изменяемая папка).

pathLength

Тип: UINT32*

Указатель на переменную, содержащую количество символов (WCHARs) в строке пути к пакету, включающую признак конца null.

Сначала вы передаете значение NULL в путь , чтобы получить количество символов. Это число используется для выделения места в памяти для пути. Затем вы передаете адрес этого пространства памяти для заполнения пути.

path

Тип: PWSTR

Указатель на пространство памяти, получающий строку пути к пакету, включающую признак конца null.

Возвращаемое значение

Тип: LONG

Если функция завершается успешно, она возвращает ERROR_SUCCESS. В противном случае функция возвращает код ошибки. Возможные коды ошибок включают следующие.

Код возврата Описание
ERROR_INSUFFICIENT_BUFFER
Буфер, указанный путем , недостаточно велик для хранения данных. Требуемый размер задается параметром pathLength.

Комментарии

Параметр packagePathType удобен для приложений, использующих расширение windows.mutablePackageDirectories в манифесте пакета. Это расширение указывает папку по пути %ProgramFiles%\ModifiableWindowsApps, в которой проецируется содержимое папки установки приложения, чтобы пользователи могли изменять файлы установки. Эта функция в настоящее время доступна только для определенных типов игр для настольных компьютеров, опубликованных корпорацией Майкрософт и нашими партнерами, и позволяет поддерживать моды на этих типах игр.

Требования

Требование Значение
Минимальная версия клиента Windows 10 [только классические приложения]
Минимальная версия сервера Windows Server 2016 [только классические приложения]
Целевая платформа Windows
Header appmodel.h
Библиотека Kernel32.lib
DLL KernelBase.dll

См. также раздел

GetPackagePathByFullName