Método IWiaAppErrorHandler::ReportStatus
Manipula mensagens de erro e status do dispositivo durante transferências de dados de imagem e exibe as mensagens para o usuário.
Sintaxe
HRESULT ReportStatus(
[in] LONG lFlags,
[in] IWiaItem2 *pWiaItem2,
[in] HRESULT hrStatus,
[in] LONG lPercentComplete
);
Parâmetros
-
lFlags [in]
-
Tipo: LONG
Não usado. Defina como 0.
-
pWiaItem2 [in]
-
Tipo: IWiaItem2*
Ponteiro para o item que está sendo transferido.
-
hrStatus [in]
-
Tipo: HRESULT
Código de status do dispositivo.
-
lPercentComplete [in]
-
Tipo: LONG
Percentual concluído da operação atual.
Valor retornado
Tipo: HRESULT
Retorna hrStatus se a recuperação do erro não for possível. Caso contrário, ele retornará um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
Se hrStatus for um erro, a ação apropriada foi tomada para corrigir o erro e a transferência poderá continuar. Se hrStatus for informativo, o usuário foi informado com uma caixa de diálogo de modelagem e optou por não cancelar a transferência. |
|
O usuário cancelou a transferência da caixa de diálogo modeless do manipulador de erros. Esse valor pode ser retornado a qualquer momento, independentemente do hrStatus . |
|
Nenhuma ação foi tomada; ou seja, nenhuma caixa de diálogo foi apresentada ao usuário. O próximo manipulador de erros será invocado. A ordem dos manipuladores de erro é: aplicativo, driver e padrão do sistema. |
Comentários
O parâmetro lPercentComplete permite que uma janela do manipulador de erros mostre o progresso. Por exemplo, um driver pode fornecer uma estimativa de quanto tempo leva o "aquecimento". O parâmetro lPercentComplete passado para IWiaAppErrorHandler::ReportStatus é o mesmo valor que o lPercentComplete que o driver define na estrutura WiaTransferParams .
Um manipulador de erros pode usar as macros SUCCEEDED e FAILED para descobrir se hrStatus tem SEVERITY_ERROR ou SEVERITY_SUCCESS.
Se hrStatus for SEVERITY_SUCCESS, o usuário deverá ter permissão para cancelar a transferência.
Se hrStatus for SEVERITY_ERROR, o manipulador de erros deverá exibir uma caixa de diálogo modal de propriedade da janela pai do aplicativo.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| IDL |
|
| Biblioteca |
|