Что означает код HRESULT 0x00040002 (OLE_S_MAC_CLIPFORMAT)?

Код состояния / ошибки:

Категория:

Имя константы:

Источник:

Подсистема (Facility):

Операционная система:

Описание:

Распознан legacy-формат буфера обмена Macintosh

Предыдущий	Следующий
OLE_S_STATIC	DRAGDROP_S_DROP

OLE_S_MAC_CLIPFORMAT

Распознан legacy-формат буфера обмена Macintosh

это HRESULT 262146 (0x00040002) из winerror.h. AllStat описывает OLE_S_MAC_CLIPFORMAT как «Формат буфера обмена Macintosh». Старший бит severity сброшен, поэтому это успешный результат, но он сообщает больше, чем обычный S_OK.

Операция передачи данных OLE завершилась успешно и определила данные как формат буфера обмена Macintosh, для которого может требоваться legacy-сопоставление форматов.

Граница состояния, которую нужно подтвердить

Главный вопрос для этого результата — соответствуют ли объявленный clipboard format, порядок байтов, encoding и storage medium converter, который будет обрабатывать данные. для этого результата сам HRESULT не подтверждает завершение несвязанной работы и не гарантирует качество необязательных выходных данных.

Надёжная Интерпретация этого результата точно указывает контракт метода, поколение объекта и выходные данные, которые остаются действительными. для этого результата, это не позволяет ошибочно считать результат «успех с дополнительной информацией» ни полным успехом, ни обычной ошибкой.

Где встречается этот результат

Этот HRESULT может появляться при межплатформенном импорте документов; фиксируйте интерфейс и метод, вернувшие результат, а не делайте вывод только по символическому имени.
Этот HRESULT может появляться в коде преобразования OLE clipboard; фиксируйте интерфейс и метод, вернувшие результат, а не делайте вывод только по символическому имени.
Этот HRESULT может появляться в архивных приложениях, встречающих embedded-данные старого Macintosh-происхождения; фиксируйте интерфейс и метод, вернувшие результат, а не делайте вывод только по символическому имени.

Для этого результата, одно и то же числовое успешное значение может быть обработано неверно, если обёртка оставляет только Boolean. для этого результата сохраняйте исходный HRESULT до оценки выходных данных и перехода состояния, относящихся к конкретному коду.

Какие доказательства и телеметрию сохранить

Сохраните идентификатор clipboard format.
Сохраните поля FORMATETC и значение tymed.
Сохраните метаданные исходного приложения и платформы.
Сохраните исходную длину данных и хеш до преобразования.
Сохраните выбранную процедуру преобразования и полученный формат.

Также зафиксируйте ole_s_mac_clipformat_operation, ole_s_mac_clipformat_object, ole_s_mac_clipformat_state_before, ole_s_mac_clipformat_state_after, время UTC, идентификаторы процесса и потока, а также correlation ID. для этого результата, не записывайте секреты в журналы, но сохраните GUID, CLSID, подтипы media, идентификаторы свойств, идентификаторы строк и хеши, необходимые для различения объектов.

Последовательность диагностики

Для этого результата, зафиксируйте исходный HRESULT 0x00040002 сразу после возврата из метода и запишите, использовал ли вызывающий код SUCCEEDED, FAILED, проверку на точное равенство или преобразование в исключение.
Определите точного владельца OLE_S_MAC_CLIPFORMAT: интерфейс, метод, экземпляр объекта, версию поставщика или фильтра, поток или apartment и фазу операции.
Проверьте решающую границу контракта для этого результата: объявленный clipboard format, порядок байтов, encoding и storage medium соответствуют converter, который будет обрабатывать данные.
Проверьте каждый выходной параметр, счётчик, массив статусов, возвращённый интерфейс и побочный эффект, который документация метода связывает с этим результатом «успех с дополнительной информацией».
Сравните наблюдаемое состояние до и после этого результата; не предполагайте, что признак успешной severity означает завершение каждой необязательной подоперации.
Для этого результата, воспроизведите минимальный запрос с тем же состоянием объекта, а перед повтором измените только условие, подтверждённое собранными данными.

Правильная обработка, повтор и восстановление

Сохраните исходные байты и выполните преобразование, специфичное для формата. Не интерпретируйте данные как обычный Windows clipboard format только потому, что HRESULT означает успех.

Повторяйте OLE_S_MAC_CLIPFORMAT только когда зафиксированное состояние действительно может изменить документированный результат. для этого результата, повтор того же вызова неуместен для устойчивого признака конца, отмены, неподдерживаемого формата, скорректированного свойства или частичного результата, уже выполненные побочные эффекты которого ещё не согласованы.

Практический сценарий проверки

Утилита импорта читает старый compound document и встречает Macintosh clipboard presentation. Она записывает исходный формат, преобразует его в поддерживаемое Windows-представление и сравнивает результат рендеринга с исходным preview.

Негативный тест должен сохранять условие, приводящее к этому HRESULT; тест восстановления должен менять только это условие и проверять как конечное состояние, так и HRESULT.

Отличие от соседних значений HRESULT

OLE_S_STATIC относится к активности объекта; к представлению и происхождению передаваемых clipboard-данных.

Для этого результата, это различие определяет, должен ли вызывающий код принять частичные результаты, завершить перечисление, подождать, изменить конфигурацию, уведомить пользователя либо вообще не выполнять восстановление после ошибки.

Ссылки

Microsoft: коды ошибок COM для OLE — официальная документация, относящаяся к этому HRESULT.
Microsoft: форматы буфера обмена — официальная документация, относящаяся к этому HRESULT.
Microsoft: FORMATETC — официальная документация, относящаяся к этому HRESULT.

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