Что означает код HRESULT 0x80080202 (APPX_E_RELATIONSHIPS_NOT_ALLOWED)?

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

Категория:

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

Источник:

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

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

Описание:

Файл не является допустимым пакетом AppX: он содержит отношения OPC.

Предыдущий	Следующий
APPX_E_INTERLEAVING_NOT_ALLOWED	APPX_E_MISSING_REQUIRED_FILE

APPX_E_RELATIONSHIPS_NOT_ALLOWED

Что означает APPX_E_RELATIONSHIPS_NOT_ALLOWED и где искать причину

Код APPX_E_RELATIONSHIPS_NOT_ALLOWED, числовое значение 0x80080202, фиксирует конкретный результат операции. Файл не является допустимым пакетом AppX: он содержит отношения OPC.

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

Почему важен контекст вызова

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

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

В имени APPX_E_RELATIONSHIPS_NOT_ALLOWED закодированы ориентиры для расследования: APPX — технический признак «appx»; RELATIONSHIPS — связи пакета; NOT — отсутствие требуемого условия; ALLOWED — технический признак «allowed». Для APPX_E_RELATIONSHIPS_NOT_ALLOWED эти ориентиры задают конкретный предмет проверки, но не заменяют контракт вызвавшего API.

Интерпретация HRESULT: признаки в имени константы

Для APPX_E_RELATIONSHIPS_NOT_ALLOWED часть APPX относится к области «технический признак «appx»». При разборе APPX_E_RELATIONSHIPS_NOT_ALLOWED проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.

Маркер RELATIONSHIPS в APPX_E_RELATIONSHIPS_NOT_ALLOWED направляет проверку на связи пакета. Для APPX_E_RELATIONSHIPS_NOT_ALLOWED сопоставьте этот признак с фактическими параметрами первого неуспешного вызова.

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

Для APPX_E_RELATIONSHIPS_NOT_ALLOWED часть ALLOWED относится к области «технический признак «allowed»». При разборе APPX_E_RELATIONSHIPS_NOT_ALLOWED проверьте, какое состояние этого объекта ожидалось и какое наблюдалось реально.

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

Минимальный набор свидетельств

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

Как локализовать причину

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

Как доказать исправление

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

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

Полезные материалы

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