| Предыдущий | Следующий |
| PEER_E_INVALID_CLASSIFIER | PEER_E_INVALID_ROLE_PROPERTY |
PEER_E_INVALID_FRIENDLY_NAME
Граница компонента
Практический смысл PEER_E_INVALID_FRIENDLY_NAME (0X80632070): peer API отклонил некорректный отображаемое имя. В трассировке отделяйте маркер «invalid friendly name» от последующих wrapper/UI ошибок: они могут появиться уже после первичной границы и не объясняют исходное состояние.
Что записать
До повторной попытки запишите Peer API, graph/group/identity handle и текущее lifecycle-состояние. Для условия «peer API отклонил некорректный отображаемое имя» эти данные важнее общего текста сообщения, потому что позволяют связать результат с конкретным владельцем операции.
- peer API, graph/group/identity handle и operation generation.
- конкретный ID/name/role, участвующий в операции.
- первый HRESULT и предшествующий успешный переход состояния.
| Наблюдение | Что оно означает |
|---|---|
| Первый вызов возвращает PEER_E_INVALID_FRIENDLY_NAME | Граница «peer API отклонил некорректный отображаемое имя» относится к текущему объекту и generation; сохраните это состояние до cleanup. |
| После одного целевого изменения код исчезает | Связь с условием «peer API отклонил некорректный отображаемое имя» подтверждается только если остальные входы и owning context не изменились. |
| Первым становится другой HRESULT | Считайте его новой первичной границей; маркер «invalid friendly name» больше не должен подменять причину следующего отказа. |
Специфическая проверка для этого кода
Проверьте friendly-name отдельно от peer name: длину, допустимые символы, encoding и наличие terminator. Friendly name является отображаемой строкой и не должен использоваться как DNS-compatible peer host name. Контроль — тот же объект с коротким Unicode friendly name при неизменных identity и classifier.
Повтор с тем же контекстом
Контрольный запуск должен воспроизводить «peer API отклонил некорректный отображаемое имя» на тех же исходных данных. Затем исправьте только поле, структуру, token или registration value, которое отклонил компонент. Если операция проходит прежнюю стадию, гипотеза локализована; если нет — вернитесь к первому HRESULT и сохранённым полям.
- Зафиксируйте первый
PEER_E_INVALID_FRIENDLY_NAMEи объект, которому принадлежит маркер «invalid friendly name». - Сохраните входные данные и lifecycle-state до изменения условия «peer API отклонил некорректный отображаемое имя».
- Измените только состояние, связанное с «peer API отклонил некорректный отображаемое имя», и выполните тот же вызов ещё раз.
Правильный уровень исправления
Не удаляйте всю peer-базу, identities или firewall rules до фиксации конкретного graph/group/record state. Исправление считается реальным, когда прежняя граница «peer API отклонил некорректный отображаемое имя» пройдена на сопоставимом входе, а не просто скрыта более общим сообщением.
Документация
- Microsoft: Grouping API functions.
- Microsoft: How to connect to a peer group.
- Microsoft: How group security works.
- Microsoft Open Specifications: Peer-to-peer grouping overview.
Нужно найти другой код? Найти другой код состояния или ошибки.