| Предыдущий | Следующий |
| MQ_ERROR_QUEUE_NOT_FOUND | MQ_ERROR_QUEUE_EXISTS |
MQ_ERROR_QUEUE_NOT_ACTIVE
Практический разбор MQ_ERROR_QUEUE_NOT_ACTIVE
MQ_ERROR_QUEUE_NOT_ACTIVE — HRESULT, относящийся к области Microsoft Message Queuing. Очередь Message Queuing не открыта, остановлена либо неактивна для запрошенной операции.
В случае MQ_ERROR_QUEUE_NOT_ACTIVE код относится к Microsoft Message Queuing и может описывать очередь, форматное имя, дескриптор, буфер свойства, службу каталогов или локальный queue manager.
Практический вывод для MQ_ERROR_QUEUE_NOT_ACTIVE: этот HRESULT фиксирует описанное условие, но сам по себе не показывает, какой участник операции первым нарушил контракт. Для MQ_ERROR_QUEUE_NOT_ACTIVE найдите первый вызов, вернувший статус, и только после этого меняйте конфигурацию подсистемы Microsoft Message Queuing.
Как читать имя MQ_ERROR_QUEUE_NOT_ACTIVE
Имя MQ_ERROR_QUEUE_NOT_ACTIVE помогает сузить поиск: ERROR — ошибка; QUEUE — очередь; NOT — отрицание условия; ACTIVE — технический маркер «active». Эти части имени не заменяют документацию API, но позволяют проверить, что журнал и код относятся к одному и тому же условию.
Особенность MQ_ERROR_QUEUE_NOT_ACTIVE
Проверьте, что приложение сохранило открытый экземпляр именно нужной очереди и не продолжает фоновую работу после её удаления, отключения или замены. Недействительный queue instance не оживает повтором операции — очередь требуется открыть заново и восстановить подписки.
Что проверить в первую очередь
В случае MQ_ERROR_QUEUE_NOT_ACTIVE важно сохранить исходный контекст вызова: имя функции, параметры, состояние объекта и первый низкоуровневый статус. В случае MQ_ERROR_QUEUE_NOT_ACTIVE без этого одинаковый HRESULT может ошибочно связываться с разными причинами.
- При разборе MQ_ERROR_QUEUE_NOT_ACTIVE проверьте состояние службы MSMQ, достижимость удалённой машины и подключение к службе каталогов при необходимости.
- При разборе MQ_ERROR_QUEUE_NOT_ACTIVE сверьте размеры буферов свойств и повторите запрос по документированной схеме определения требуемой длины.
- При разборе MQ_ERROR_QUEUE_NOT_ACTIVE проверьте ACL очереди и системные привилегии под фактической учётной записью процесса.
- При разборе MQ_ERROR_QUEUE_NOT_ACTIVE запишите path name и format name очереди, тип операции, права доступа и свойства, которые читались или записывались.
Как локализовать источник
- Для MQ_ERROR_QUEUE_NOT_ACTIVE не создавайте дубликат очереди до проверки существующего path name и instance identifier.
- Для MQ_ERROR_QUEUE_NOT_ACTIVE сохраните HRESULT, PROPID, фактическую/требуемую длину и тип форматного имени.
- Для MQ_ERROR_QUEUE_NOT_ACTIVE проверьте воспроизведение на локальной private queue, чтобы отделить сеть и каталог от API-контракта.
Проверка после изменения
В случае MQ_ERROR_QUEUE_NOT_ACTIVE считайте причину MQ_ERROR_QUEUE_NOT_ACTIVE устранённой только после проверки на тех же данных и под той же учётной записью, где возник сбой, а затем выполните контрольный тест с заведомо неверным входом.
Ссылки по MQ_ERROR_QUEUE_NOT_ACTIVE
Нужно найти другой код? Найти другой код состояния или ошибки.