Método IWiaDevMgr2::GetImageDlg
O método IWiaDevMgr2::GetImageDlg exibe uma ou mais caixas de diálogo que permitem que um usuário adquira uma imagem de um dispositivo WIA (Aquisição de Imagens do Windows) 2.0 e escreva a imagem em um arquivo especificado. Esse método estende a funcionalidade de IWiaDevMgr2::SelectDeviceDlg para encapsular a aquisição de imagem em uma única chamada à API.
Sintaxe
HRESULT GetImageDlg(
[in] LONG lFlags,
[in] BSTR bstrDeviceID,
[in] HWND hwndParent,
[in] BSTR bstrFolderName,
[in] BSTR bstrFilename,
[in] LONG *plNumFiles,
[in] BSTR **ppbstrFilePaths,
[in, out] IWiaItem2 **ppItem
);
Parâmetros
-
lFlags [in]
-
Tipo: LONG
Especifica o comportamento da caixa de diálogo. Pode ser definido com os seguintes valores:
Sinalizador Significado 0 Comportamento padrão. WIA_DEVICE_DIALOG_USE_COMMON_UI Use a interface do usuário do sistema em vez da interface do usuário fornecida pelo fornecedor. Se a interface do usuário do sistema não estiver disponível, a interface do usuário do fornecedor será usada. Se nenhuma interface do usuário estiver disponível, a função retornará E_NOTIMPL. -
bstrDeviceID [in]
-
Tipo: BSTR
Especifica o scanner a ser usado.
-
hwndParent [in]
-
Digite: HWND
Um identificador da janela que possui a caixa de diálogo Obter Imagem .
-
bstrFolderName [in]
-
Tipo: BSTR
Especifica o nome da pasta em que ito armazena os arquivos verificados.
-
bstrFilename [in]
-
Tipo: BSTR
Especifica o nome do arquivo no qual gravar os dados da imagem.
-
plNumFiles [in]
-
Tipo: LONG*
Um ponteiro para o número de arquivos a serem digitalizados.
-
ppbstrFilePaths [in]
-
Tipo: BSTR**
O endereço de um ponteiro para uma matriz de caminhos para os arquivos verificados. Inicialize o ponteiro para apontar para uma matriz de tamanho zero (0) antes que IWiaDevMgr2::GetImageDlg seja chamado. Veja os Comentários.
-
ppItem [in, out]
-
Tipo: IWiaItem2**
O endereço de um ponteiro para o IWiaItem2 do qual as imagens foram verificadas.
Valor retornado
Tipo: HRESULT
IWiaDevMgr2::GetImageDlg retornará S_OK se os dados forem transferidos com êxito, retornará S_FALSE se o usuário cancelar a caixa de diálogo ou retornar um erro COM padrão.
Observação
O parâmetro ppbstrFilePaths não estará necessariamente vazio, se a função retornar S_FALSE. Se o usuário cancelar, as páginas que concluíram a verificação serão processadas e retornadas em ppbstrFilePaths. Mesmo que eles não sejam usados, você deve liberar a matriz. Veja os Comentários.
Comentários
Se o aplicativo passar NULL para o valor do parâmetro bstrDeviceID , IWiaDevMgr2::GetImageDlg exibirá a caixa de diálogo Selecionar Dispositivo para que o usuário possa selecionar o dispositivo de entrada WIA 2.0.
Use um item de menu chamado De scanner no menu Arquivo para que as seleções de dispositivo e imagem estejam disponíveis em seu aplicativo.
Chame SysFreeString em cada BSTR na matriz para a qual ppbstrFilePaths[i] aponta e chame CoTaskMemFree na própria matriz para liberar memória associada. Se S_FALSE for retornado, marcar para ver se o valor para o qual plNumFiles aponta não é zero. Se o valor não for zero, libere os recursos ppbstrFilePaths[i] no aplicativo, pois o usuário pode cancelar após a verificação de uma ou mais páginas. Inicialize plNumFiles como zero antes de chamar IWiaDevMgr2::GetImageDlg. Se plNumFiles não for inicializado como zero e uma falha na infraestrutura COM fizer com que a função retorne S_FALSE antes que IWiaDevMgr2::GetImageDlg seja chamado, plNumFiles terá um valor de lixo enganoso.
A caixa de diálogo deve ter direitos suficientes para bstrFolderName para que possa salvar os arquivos com nomes de arquivo exclusivos. Proteja a pasta com uma ACL (lista de controle de acesso) porque ela contém dados do usuário.
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 |
|