HRESULT 0x80080203 (APPX_E_MISSING_REQUIRED

Код состояния / ошибки:

Категория:

Имя константы:

Источник:

Подсистема (Facility):

Операционная система:

Описание:

Файл не является допустимым пакетом AppX: отсутствует манифест или карта блоков либо, при наличии файла контроля целостности кода, отсутствует файл подписи.

Предыдущий	Следующий
APPX_E_RELATIONSHIPS_NOT_ALLOWED	APPX_E_INVALID_MANIFEST

APPX_E_MISSING_REQUIRED_FILE

APPX_E_MISSING_REQUIRED_FILE: значение HRESULT и практическая диагностика

Windows возвращает APPX_E_MISSING_REQUIRED_FILE (0x80080203), когда выполняется следующее условие: Файл не является допустимым пакетом AppX: отсутствует манифест или карта блоков либо, при наличии файла контроля целостности кода, отсутствует файл подписи.

Для APPX_E_MISSING_REQUIRED_FILE старший бит HRESULT делает значение ошибкой. Константа APPX_E_MISSING_REQUIRED_FILE объявлена в winerror.h и относится к области «упаковка AppX/MSIX».

Контекст подсистемы

Для APPX_E_MISSING_REQUIRED_FILE код возникает на границе проверки структуры пакета: Windows сопоставляет манифест, карту блоков, подпись и фактическое расположение файлов. Для APPX_E_MISSING_REQUIRED_FILE ошибка упаковки должна исследоваться на исходном артефакте сборки, а не после ручного редактирования ZIP-контейнера.

Для APPX_E_MISSING_REQUIRED_FILE не следует начинать с очистки состояния или переустановки компонента. Для APPX_E_MISSING_REQUIRED_FILE сначала необходимо привязать результат к одному вызову, объекту и поколению его состояния.

В имени APPX_E_MISSING_REQUIRED_FILE закодированы ориентиры для расследования: APPX — технический признак «appx»; MISSING — отсутствующий объект; REQUIRED — обязательное условие; FILE — файл. Для APPX_E_MISSING_REQUIRED_FILE эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.

Смысл результата: признаки в имени константы

Маркер APPX в APPX_E_MISSING_REQUIRED_FILE направляет проверку на технический признак «appx». Для APPX_E_MISSING_REQUIRED_FILE сопоставьте этот признак с фактическими параметрами первого неуспешного вызова.

Для APPX_E_MISSING_REQUIRED_FILE часть MISSING относится к области «отсутствующий объект». При разборе APPX_E_MISSING_REQUIRED_FILE проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.

Компонент имени REQUIRED уточняет смысл APPX_E_MISSING_REQUIRED_FILE: речь идёт про обязательное условие. Для APPX_E_MISSING_REQUIRED_FILE эту границу следует воспроизвести отдельно от последующей обработки ошибки.

При разборе APPX_E_MISSING_REQUIRED_FILE обозначение FILE связывает код с темой «файл». До повторной проверки APPX_E_MISSING_REQUIRED_FILE сохраните входные данные без нормализации.

Для APPX_E_MISSING_REQUIRED_FILE в техническом контексте особенно важны: карта блоков, AppX/MSIX. При расследовании APPX_E_MISSING_REQUIRED_FILE их следует проверять как связанные части одной операции, а не как независимые симптомы.

Диагностические данные

На границе сбоя по APPX_E_MISSING_REQUIRED_FILE нужно сохранить исходный .appx/.msix и его SHA-256 до повторной упаковки.
Для сравнения с исправным случаем по APPX_E_MISSING_REQUIRED_FILE нужно зафиксировать версию MakeAppx, SignTool и параметры конвейера сборки.
До повторной попытки по APPX_E_MISSING_REQUIRED_FILE нужно сравнить AppxManifest.xml, AppxBlockMap.xml и список файлов с успешным пакетом.
Для воспроизводимого отчёта по APPX_E_MISSING_REQUIRED_FILE нужно проверить, не переписывает ли пакет этап публикации, сжатия или доставки.
В первичном журнале по APPX_E_MISSING_REQUIRED_FILE нужно сохранить журнал AppXDeployment-Server и полный PackageFullName.

Проверка по шагам

Для APPX_E_MISSING_REQUIRED_FILE: Проверить пакет штатным средством MakeAppx validate и отдельно проверить подпись; повторите шаг на исправном контрольном примере.
Для APPX_E_MISSING_REQUIRED_FILE: Сравнить проблемный артефакт с файлом, непосредственно полученным на этапе сборки; сохраните первый hresult и точное время результата.
Для APPX_E_MISSING_REQUIRED_FILE: Исключить ручную распаковку и повторное архивирование обычным ZIP-инструментом; отдельно отметьте изменение состояния объекта.
Для APPX_E_MISSING_REQUIRED_FILE: Пересобрать пакет из чистого каталога и подписать уже окончательный файл; все остальные условия оставьте неизменными.
Для APPX_E_MISSING_REQUIRED_FILE: Повторить установку на чистом тестовом профиле и проверить журнал развёртывания; не удаляйте исходные данные до завершения сравнения.

Корректирующие действия

Корректирующее действие для APPX_E_MISSING_REQUIRED_FILE должно устранять условие «Файл не является допустимым пакетом AppX: отсутствует манифест или карта блоков либо, при наличии файла контроля целостности кода, отсутствует файл подписи» на уровне карта блоков. Для APPX_E_MISSING_REQUIRED_FILE простое подавление HRESULT, бесконечный повтор или очистка всех настроек не доказывают восстановление контракта.

Для APPX_E_MISSING_REQUIRED_FILE исправление считается подтверждённым, когда исходная операция проходит в том же окружении, отрицательный тест по-прежнему предсказуемо отклоняется, а журнал не содержит нового скрытого сбоя.

Документация

Нужно найти другой код? Найти другой код состояния или ошибки.