Функция 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. В противном случае функция возвращает код ошибки. Возможные коды ошибок включают следующие.
Код возврата | Описание |
---|---|
|
Буфер, указанный путем , недостаточно велик для хранения данных. Требуемый размер задается параметром pathLength. |
Комментарии
Параметр packagePathType удобен для приложений, использующих расширение windows.mutablePackageDirectories в манифесте пакета. Это расширение указывает папку по пути %ProgramFiles%\ModifiableWindowsApps, в которой проецируется содержимое папки установки приложения, чтобы пользователи могли изменять файлы установки. Эта функция в настоящее время доступна только для определенных типов игр для настольных компьютеров, опубликованных корпорацией Майкрософт и нашими партнерами, и позволяет поддерживать моды на этих типах игр.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 10 [только классические приложения] |
Минимальная версия сервера | Windows Server 2016 [только классические приложения] |
Целевая платформа | Windows |
Header | appmodel.h |
Библиотека | Kernel32.lib |
DLL | KernelBase.dll |