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

Статья
02/07/2025

Метод 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клиенты интерфейса IStillImage IStillImage должны вызывать IStillImage::StiCreateInstance для получения указателя интерфейса IStillImage.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	sti.h (include Sti.h)

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