Поделиться через

Метод IStillImageW::WriteToErrorLog (sti.h)

  • Статья

Метод IStillImage::WriteToErrorLog записывает сообщение в журнал ошибок неподвижного образа.

Синтаксис

HRESULT WriteToErrorLog(
       DWORD   dwMessageType,
  [in] LPCWSTR pszMessage
);

Параметры

dwMessageType

Значение константы, предоставленное вызывающим абонентом, представляющее тип сообщения. В Sti.h определены следующие значения:

STI_TRACE_INFORMATION

STI_TRACE_WARNING

STI_TRACE_ERROR

[in] pszMessage

Предоставленный вызывающим абонентом указатель на строку сообщения, которая будет записана в файл журнала.

Возвращаемое значение

Если операция выполнена успешно, метод возвращает S_OK. В противном случае возвращается один из кодов ошибок с префиксом STIERR, определенных в файле stierr.h.

Комментарии

Файл журнала ошибок неподвижного образа называется sti_trace.log и находится в каталоге Windows. Значения реестра определяют, какие типы ошибок образа (информационные, предупреждения или ошибки) записываются в журнал ошибок (см. раздел Неизменяемые записи реестра).

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

Перед вызовом IStillImage::WriteToErrorLog клиенты COM-интерфейса IStillImage должны вызвать IStillImage::StiCreateInstance , чтобы получить указатель интерфейса IStillImage .

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть sti.h (включая Sti.h)