| Предыдущий | Следующий |
| NS_E_WMPXML_EMPTYDOC | NS_E_WMP_FILESCANALREADYSTARTED |
NS_E_WMP_PATH_ALREADY_IN_LIBRARY
Что именно выделяет HRESULT
Символьный результат NS_E_WMP_PATH_ALREADY_IN_LIBRARY сужает значение 0xC00D0FBA к условию уже существующего пути в медиатеке: медиатека уже содержит запись для канонизированного пути к медиафайлу. Сохраняйте сведения о конфликте пути, даже если последующее сообщение сводит ошибку к общей медиаошибке.
Для дополнительной проверки сравните нормализованный путь, ID файла и существующий объект Media, а не только строковое написание; это полезнее переустановки проигрывателя или одновременного изменения нескольких несвязанных настроек.
Состояние, которое стоит сохранить
Зафиксируйте состояние до очистки состояния проигрывателя:
- Решающая проверка: сравните нормализованный путь, ID файла и существующий объект Media, а не только строковое написание.
- Артефакт: тип медиатеки, идентификатор базы данных и профиль пользователя, которому принадлежит операция.
- Состояние: канонический локальный, UNC- или URL-путь и идентификатор файла.
- Идентичность объекта: идентификатор медиаобъекта или идентификатор контейнера/элемента HME.
- Исходные данные: поколение сканирования или поиска и запрос, который его заменил.
- Корреляция: первый HRESULT медиатеки или файловой системы до сводного результата уровня Player.
Записывайте в журнал пути, хэши, идентификаторы, смещения и HRESULT. Не включайте в журналы секретные и не относящиеся к сбою данные.
Воспроизведение без потери диагностических данных
- Найдите первый компонент, вернувший исходный HRESULT, и пометьте это событие как данную границу.
- Сохраните входные данные и идентичность объекта сбойной операции до того, как резервный путь или очистка WMP изменит состояние.
- Восстановите непосредственно предшествовавшее успешное состояние и определите вызов или событие, после которого возник сбой.
- Проведите проверку для этого кода: сравните нормализованный путь, ID файла и существующий объект Media, а не только строковое написание.
- Внесите минимальное исправление: используйте/обновите существующую запись либо удалите устаревшую через API медиатеки и повторите исходную операцию.
Что успешно выполняется до этого сбоя
Учитывайте два правила. Добавление элемента в медиатеку не перемещает сам файл, а строка медиатеки может сохраниться после недоступности пути или общего объекта. Сканирование, поиск и Home Media Experience имеют состояние, поэтому устаревшие идентификаторы и перекрывающиеся операции следует отличать от ошибок формата.
Показательный случай: Один и тот же файл добавляется сначала по пути с буквой диска, затем по эквивалентному нормализованному пути. Пример локализует только компонент, сформировавший ошибку.
Связанные HRESULT с другими границами отказа
| Результат | Другая граница |
|---|---|
NS_E_WMP_FILESCANALREADYSTARTED | цикл сканирования файлов библиотеки уже выполняется |
NS_E_WMP_HME_INVALIDOBJECTID | идентификатор объекта Home Media Experience больше не разрешается в текущем представлении общей библиотеки |
NS_E_WMP_HME_NOTSEARCHABLEFORITEMS | Выбранный контейнер HME не объявляет поддержку поиска элементов |
Если после этого появляется более общий результат «не удаётся воспроизвести», «не удаётся загрузить» или «операция завершилась ошибкой», сохраняйте более раннее событие. Более поздний код может быть следствием работы оболочки, резервного элемента или слоя интерфейса, а не исходным сбоем.
Восстановление на правильном уровне
Устраняйте NS_E_WMP_PATH_ALREADY_IN_LIBRARY где формируется это состояние: используйте/обновите существующую запись либо удалите устаревшую через API медиатеки. После исправления перезагрузите или пересоздайте владеющий объект, чтобы закэшированная ошибка не исказила повторную проверку.
- Не удаляйте всю медиабазу до экспорта идентификаторов и путей сбойных объектов: это может уничтожить артефакт или состояние, необходимые для объяснения исходного результата.
- Не считайте успешное открытие файла доказательством актуальности записи медиатеки и представления общего доступа; это может заменить исходный HRESULT вторичной ошибкой другого уровня.
Практическая интерпретация
Используйте NS_E_WMP_PATH_ALREADY_IN_LIBRARY, 0xC00D0FBA и символическую фразу вместе в трассировке. Сопоставляйте их с API и идентификатором объекта.
Как убедиться, что исправлена именно причина
Повторите действие, вернувшее исходный HRESULT, и убедитесь, что тот же объект проходит прежнюю контрольную точку. Успех означает достижение следующего ожидаемого состояния загрузки, разбора, списка воспроизведения, управления или воспроизведения, а не простое исчезновение сообщения.
Технические ссылки
- Программный доступ к библиотеке — нормативный или платформенный материал для этого результата.
- Объект MediaCollection — контекст API или формата для этого результата.
- Метод MediaCollection. add — документация, используемая для определения границы-источника этого результата.
- Обработка ошибок в объектной модели WMP
Нужно найти другой код? Найти другой код состояния или ошибки.