Что означает код HRESULT 0xC03B0019 (HNS_GUID_CONVERSION_FAILURE)?

 
Предыдущий Следующий
HNS_SHARED_SWITCH_MODIFICATION HNS_REGKEY_FAILURE

HNS_GUID_CONVERSION_FAILURE

Что означает HNS_GUID_CONVERSION_FAILURE

HNS_GUID_CONVERSION_FAILURE — HRESULT, относящийся к области Host Network Service. Host Networking Service не смог преобразовать переданное значение в корректный идентификатор GUID.

В случае HNS_GUID_CONVERSION_FAILURE код относится к Host Network Service и сетям Windows Containers: network, endpoint, subnet, switch, policy или VFP-port setting.

Практический вывод для HNS_GUID_CONVERSION_FAILURE: этот HRESULT фиксирует описанное условие, но сам по себе не показывает, какой участник операции первым нарушил контракт. Для HNS_GUID_CONVERSION_FAILURE найдите первый вызов, вернувший статус, и только после этого меняйте конфигурацию подсистемы Host Network Service.

Как читать имя HNS_GUID_CONVERSION_FAILURE

Имя HNS_GUID_CONVERSION_FAILURE помогает сузить поиск: GUID — технический маркер «guid»; CONVERSION — технический маркер «conversion»; FAILURE — сбой операции. Эти части имени не заменяют документацию API, но позволяют проверить, что журнал и код относятся к одному и тому же условию.

Проверка причины

В случае HNS_GUID_CONVERSION_FAILURE важно сохранить исходный контекст вызова: имя функции, параметры, состояние объекта и первый низкоуровневый статус. В случае HNS_GUID_CONVERSION_FAILURE без этого одинаковый HRESULT может ошибочно связываться с разными причинами.

  • При разборе HNS_GUID_CONVERSION_FAILURE проверьте существование subnet, switch extension, VFP port и связанных адаптеров.
  • При разборе HNS_GUID_CONVERSION_FAILURE сопоставьте конфликт с остаточными объектами после предыдущего контейнера или перезапуска службы.
  • При разборе HNS_GUID_CONVERSION_FAILURE не удаляйте все HNS-сети без резервной фиксации конфигурации и понимания влияния на контейнеры.
  • При разборе HNS_GUID_CONVERSION_FAILURE сохраните исходный JSON, GUID сети/endpoint, тип network и список HNS-объектов.

Как воспроизвести проблему

  • Для HNS_GUID_CONVERSION_FAILURE сохраните точный JSON-запрос и ответ службы.
  • Для HNS_GUID_CONVERSION_FAILURE воспроизведите создание минимальной NAT-сети отдельно от оркестратора.
  • Для HNS_GUID_CONVERSION_FAILURE соберите HNS diagnostics и список Get-HnsNetwork/Get-HnsEndpoint.

Критерий успешного исправления

В случае HNS_GUID_CONVERSION_FAILURE для HNS_GUID_CONVERSION_FAILURE недостаточно скрыть ошибку повтором. В случае HNS_GUID_CONVERSION_FAILURE после изменения воспроизведите исходную операцию, проверьте конечное состояние объекта и убедитесь, что ресурсы освобождаются без потери первичного HRESULT.

Ссылки по HNS_GUID_CONVERSION_FAILURE


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