Метод IWiaMiniDrv::d rvGetDeviceErrorStr (wiamindr_lh.h)

Статья
02/07/2025

Метод IWiaMiniDrv::d rvGetDeviceErrorStr сопоставляет код ошибки со строкой Юникода, описывающей ошибку.

Синтаксис

HRESULT drvGetDeviceErrorStr(
  LONG     __MIDL__IWiaMiniDrv0039,
  LONG     __MIDL__IWiaMiniDrv0040,
  LPOLESTR *__MIDL__IWiaMiniDrv0041,
  LONG     *__MIDL__IWiaMiniDrv0042
);

Параметры

__MIDL__IWiaMiniDrv0039

lDevErrVal [in]

Указывает значение ошибки устройства, сопоставленное со строкой. Значение нуля указывает, что ошибка не произошла.

__MIDL__IWiaMiniDrv0040

lFlags [in]

Скрытный.

__MIDL__IWiaMiniDrv0041

plDevErr [out]

Указывает на расположение памяти, которое получит код состояния для этого метода. Если этот метод возвращает S_OK, сохраненное значение будет равно нулю. В противном случае код ошибки для мини-driver будет храниться в расположении, на которое указывает этот параметр.

__MIDL__IWiaMiniDrv0042

ppszDevErrStr [out, необязательный]

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

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

При успешном выполнении метод должен возвращать S_OK и очищать значение ошибки устройства, указываемое на plDevErr. Если мини-driver не полностью реализует этот метод, метод должен возвращать E_NOTIMPL. Если мини-driver не распознает значение ошибки, переданное этому методу, метод должен вернуть E_INVALIDARG. Если метод завершается ошибкой, он должен вернуть стандартный код ошибки COM и поместить значение кода ошибки для мини-driver в память, на которую указывает plDevErr.

Замечания

Чтобы получить строку ошибки, описывающую значение ошибки, созданное для конкретного устройства, служба WIA вызывает метод IWiaMiniDrv::d rvGetDeviceErrorStr. В ответ на этот вызов мини-driver должен использовать CoTaskMemAlloc для выделения памяти, содержащей локализованную строку Юникода, соответствующую коду ошибки, переданной мини-driver. Служба WIA (или приложение) освобождает память. Скорее всего, приложение отобразит строку, поэтому оно должно быть значимым для конечного пользователя. Строка должна быть загружена из файла ресурсов, чтобы она была локализована на различных языках.

Требования

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

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