Método IWiaErrorHandler::ReportStatus (wia_lh.h)
O método ReportStatus exibe informações sobre um erro ou status durante uma transferência. Em alguns casos, esse método permite que o usuário se recupere de um erro.
Sintaxe
HRESULT ReportStatus(
[in] LONG lFlags,
[in] HWND hwndParent,
[in] IWiaItem2 *pWiaItem2,
[in] HRESULT hrStatus,
[in] LONG lPercentComplete
);
Parâmetros
[in] lFlags
Atualmente não utilizado. Deve ser definido como zero.
[in] hwndParent
O chamador forneceu o identificador da janela que deve ser usada como a janela pai para as caixas de diálogo. Se isso estiver definido como NULL, nenhuma caixa de diálogo deverá ser exibida.
[in] pWiaItem2
Ponteiro para o item deIWiaItem2 que está sendo transferido.
[in] hrStatus
Variável HRESULT que contém o código de status recebido pelo método de transferência WIA, por exemplo, o método IWiaDataCallback::BandedDataCallback.
[in] lPercentComplete
Tamanho dos dados, em bytes, o ponteiro pbData refere-se.
Valor de retorno
Retorna um código de erro COM padrão se o erro não puder ser recuperado ou se o usuário optar por anular a transferência em resposta à caixa de diálogo exibida. Há informações adicionais sobre os valores retornados na seção comentários. Caso contrário, esse método retornará um dos seguintes valores:
Código de retorno | Descrição |
---|---|
S_OK | A ação apropriada foi tomada para corrigir o erro e a transferência pode continuar. |
S_FALSE | Nenhuma ação foi tomada para lidar com o erro ou o status do relatório para o usuário. |
Observações
O objeto de retorno de chamada de proxy COM chama o método WiaErrorHandler::ReportStatus quando o driver envia uma mensagem de IT_MSG_DEVICE_STATUS para o métodoIWiaDataCallback::BandedDataCallback. A caixa de diálogo exibida por esse método fornece ao usuário informações de erro ou status e possivelmente oferece uma oportunidade de se recuperar do erro e continuar a transferência. A interface do usuário deve fornecer apenas uma caixa de diálogo informativa e uma chance de cancelar a transferência se o HRESULT for SEVERITY_SUCCESS.
Um driver que implementa esse método deve exibir uma caixa de diálogo modal, de propriedade do hwndParent, em resposta a um valor de hrStatus para o qual COM FALHA (hrStatus) é avaliado como VERDADEIRO. Se COM FALHA (hrStatus) for avaliado como FALSE, o valor em hrStatus representará um atraso não fatal e a caixa de diálogo exibida deverá ser modeless. A caixa de diálogo deve ser removida quando o status da transferência for alterado. Um manipulador de erros deve retornar S_FALSE para valores desconhecidos de hrStatus.
O parâmetro hrStatus é definido como WIA_STATUS_TRANSFER_BEGIN para informar ao manipulador que uma transferência foi iniciada. Ele é definido como WIA_STATUS_TRANSFER_END quando a transferência é concluída.
Se hrStatus for S_OK, a transferência de dados será retomada e nenhum atraso ou erro estará em vigor no momento.
Requisitos
Requisito | Valor |
---|---|
da Plataforma de Destino | Área de trabalho |
cabeçalho | wia_lh.h (inclua Wia_lh.h) |