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

Artigo
03/01/2024

O método IWiaMiniDrv::d rvGetDeviceErrorStr mapeia um código de erro para uma cadeia de caracteres Unicode que descreve o erro.

Sintaxe

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

Parâmetros

__MIDL__IWiaMiniDrv0039

lDevErrVal [in]

Especifica o valor de erro do dispositivo a ser mapeado para uma cadeia de caracteres. Um valor zero indica que nenhum erro ocorreu.

__MIDL__IWiaMiniDrv0040

lFlags [in]

Reservado.

__MIDL__IWiaMiniDrv0041

plDevErr [out]

Aponta para um local de memória que receberá um código status para esse método. Se esse método retornar S_OK, o valor armazenado será zero. Caso contrário, um código de erro específico do minidriver será armazenado no local apontado por esse parâmetro.

__MIDL__IWiaMiniDrv0042

ppszDevErrStr [out, opcional]

Aponta para um local de memória que receberá o endereço de uma cadeia de caracteres que descreve o erro.

Retornar valor

Em caso de êxito, o método deve retornar S_OK e limpar o valor de erro do dispositivo apontado por plDevErr. Se o minidriver não implementar totalmente esse método, o método deverá retornar E_NOTIMPL. Se o minidriver não reconhecer o valor de erro passado para esse método, o método deverá retornar E_INVALIDARG. Se o método falhar, ele deverá retornar um código de erro COM padrão e colocar um valor de código de erro específico do minidriver na memória apontada por plDevErr.

Comentários

Para obter uma cadeia de caracteres de erro que descreve um valor de erro gerado por minidriver específico do dispositivo, o serviço WIA chama o método IWiaMiniDrv::d rvGetDeviceErrorStr . Em resposta a essa chamada, o minidriver deve usar CoTaskMemAlloc para alocar memória que conterá uma cadeia de caracteres Unicode localizada correspondente ao código de erro passado para o minidriver. O serviço WIA (ou um aplicativo) liberará a memória. É provável que um aplicativo exiba a cadeia de caracteres, portanto, ela deve ser significativa para um usuário final. A cadeia de caracteres deve ser carregada de um arquivo de recurso, para que possa ser localizada em uma variedade de idiomas.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	wiamindr_lh.h (inclua Wiamindr.h)

Compartilhar via