| Предыдущий | Следующий |
| PEER_E_TIMEOUT | PEER_E_FW_EXCEPTION_DISABLED |
PEER_E_INVALID_ADDRESS
Точная граница результата
Практический смысл PEER_E_INVALID_ADDRESS (0X80637007): peer API отклонил некорректный сетевой адрес. В трассировке отделяйте маркер «invalid address» от последующих 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_ADDRESS | Граница «peer API отклонил некорректный сетевой адрес» относится к текущему объекту и generation; сохраните это состояние до cleanup. |
| После одного целевого изменения код исчезает | Связь с условием «peer API отклонил некорректный сетевой адрес» подтверждается только если остальные входы и owning context не изменились. |
| Первым становится другой HRESULT | Считайте его новой первичной границей; маркер «invalid address» больше не должен подменять причину следующего отказа. |
Специфическая проверка для этого кода
Сохраните исходную endpoint address structure: address family, IPv6 bytes, scope ID и port. Валидируйте семейство и длину структуры до вызова peer API. Не подменяйте адрес peer name или host name: это другой контракт. Контроль — тот же вызов с корректно заполненным sockaddr для того же узла; изменение только address representation должно менять результат.
Сравнение двух запусков
Контрольный запуск должен воспроизводить «peer API отклонил некорректный сетевой адрес» на тех же исходных данных. Затем исправьте только поле, структуру, token или registration value, которое отклонил компонент. Если операция проходит прежнюю стадию, гипотеза локализована; если нет — вернитесь к первому HRESULT и сохранённым полям.
- Зафиксируйте первый
PEER_E_INVALID_ADDRESSи объект, которому принадлежит маркер «invalid address». - Сохраните входные данные и lifecycle-state до изменения условия «peer API отклонил некорректный сетевой адрес».
- Измените только состояние, связанное с «peer API отклонил некорректный сетевой адрес», и выполните тот же вызов ещё раз.
После исправления
Не удаляйте всю peer-базу, identities или firewall rules до фиксации конкретного graph/group/record state. Исправление считается реальным, когда прежняя граница «peer API отклонил некорректный сетевой адрес» пройдена на сопоставимом входе, а не просто скрыта более общим сообщением.
Документация
- Microsoft: About the Peer Collaboration API.
- Microsoft: Collaboration API functions.
- Microsoft: People Near Me requirements.
- Microsoft: Windows Firewall rules.
Нужно найти другой код? Найти другой код состояния или ошибки.