Método IWiaMiniDrv::d rvGetDeviceErrorStr (wiamindr_lh.h)

El método IWiaMiniDrv::d rvGetDeviceErrorStr asigna un código de error a una cadena Unicode que describe el error.

Sintaxis

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

Parámetros

__MIDL__IWiaMiniDrv0039

lDevErrVal [in]

Especifica el valor de error del dispositivo que se va a asignar a una cadena. Un valor de cero indica que no se ha producido ningún error.

__MIDL__IWiaMiniDrv0040

lFlags [in]

Reservado.

__MIDL__IWiaMiniDrv0041

plDevErr [out]

Apunta a una ubicación de memoria que recibirá un código de estado para este método. Si este método devuelve S_OK, el valor almacenado será cero. De lo contrario, este parámetro almacenará un código de error específico del minidriver en la ubicación a la que apunta este parámetro.

__MIDL__IWiaMiniDrv0042

ppszDevErrStr [out, optional]

Apunta a una ubicación de memoria que recibirá la dirección de una cadena que describe el error.

Valor devuelto

Si se ejecuta correctamente, el método debe devolver S_OK y borrar el valor de error del dispositivo al que apunta plDevErr. Si el minidriver no implementa completamente este método, el método debe devolver E_NOTIMPL. Si el minidriver no reconoce el valor de error pasado a este método, el método debe devolver E_INVALIDARG. Si se produce un error en el método, debe devolver un código de error COM estándar y colocar un valor de código de error específico del minidriver en la memoria a la que apunta plDevErr.

Comentarios

Para obtener una cadena de error que describe un valor de error generado por minidriver específico del dispositivo, el servicio WIA llama al método IWiaMiniDrv::d rvGetDeviceErrorStr . En respuesta a esta llamada, el minidriver debe usar CoTaskMemAlloc para asignar memoria que contendrá una cadena Unicode localizada correspondiente al código de error pasado al minidriver. El servicio WIA (o una aplicación) liberará la memoria. Es probable que una aplicación muestre la cadena, por lo que debe ser significativo para un usuario final. La cadena debe cargarse desde un archivo de recursos para que se pueda localizar en diversos idiomas.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	wiamindr_lh.h (incluya Wiamindr.h)