Método IWiaErrorHandler::ReportStatus
Manipula status e mensagens de erro durante transferências de dados de imagem e as exibe para o usuário.
Sintaxe
HRESULT ReportStatus(
[in] HWND hwndParent,
[in] IUnknown *punkItem,
[in] HRESULT hrStatus,
[in] LONG cbResLength,
[in] BYTE *pbData
);
Parâmetros
-
hwndParent [in]
-
Digite: HWND
HWND que é a janela pai da janela de mensagem.
-
punkItem [in]
-
Tipo: IUnknown*
Ponteiro para a interface IUnknown do item que está sendo transferido. Esse objeto implementa minimamente IWiaItem2 e IWiaDataTransfer.
-
hrStatus [in]
-
Tipo: HRESULT
HRESULT que é o código status recebido por BandedDataCallback.
-
cbResLength [in]
-
Tipo: LONG
LONG que é o tamanho dos dados referenciados por pbData.
-
pbData [in]
-
Tipo: BYTE*
Ponteiro para o buffer de dados, conforme recebido por BandedDataCallback.
Valor retornado
Tipo: HRESULT
Retornará hrStatus se o erro não puder ser recuperado. Caso contrário, ele retornará um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
A ação apropriada foi tomada para corrigir o erro e a transferência pode continuar. |
|
Nenhuma ação foi tomada para lidar com o erro ou relatar status ao usuário. |
|
O usuário optou por anular a transferência em resposta à caixa de diálogo exibida. |
Comentários
A WIA (Aquisição de Imagens do Windows) 2.0 chama IWiaErrorHandler::ReportStatus quando o driver envia uma mensagem de IT_MSG_DEVICE_STATUS para BandedDataCallback. Esse método manipula a mensagem e exibe informações ao usuário sobre a status ou o erro. Se a mensagem for sobre um erro, o método permitirá que o usuário escolha, se possível, se deseja se recuperar do erro e continuar a transferência ou anular.
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 SEVERITY_SUCCESS, o usuário deverá ter permissão para cancelar a transferência.
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 |
|