Estrutura DEVICEDIALOGDATA2

Define os dados necessários para chamar uma caixa de diálogo de dispositivo.

Sintaxe

typedef struct {
  DWORD     cbSize;
  IWiaItem2 *pIWiaItemRoot;
  DWORD     dwFlags;
  HWND      hwndParent;
  BSTR      bstrFolderName;
  BSTR      bstrFilename;
  LONG      lNumFiles;
  BSTR      *pbstrFilePaths;
  IWiaItem2 *ppWiaItem;
} DEVICEDIALOGDATA2;

Membros

cbSize

Tipo: DWORD

Especifica o tamanho dessa estrutura em bytes.

pIWiaItemRoot

Tipo: IWiaItem2*

Aponta para uma interface IWiaItem2 que representa o item raiz válido na árvore de itens do aplicativo.

dwFlags

Tipo: DWORD

Especifica um conjunto de sinalizadores que controlam a operação da caixa de diálogo. Pode ser definido como qualquer um dos seguintes valores:

Sinalizador	Significado
0	Comportamento padrão.
WIA_DEVICE_DIALOG_SINGLE_IMAGE	Restrinja a seleção de imagem a uma única imagem na caixa de diálogo de aquisição de imagem do dispositivo.
WIA_DEVICE_DIALOG_USE_COMMON_UI	Use a interface do usuário do sistema, se disponível, 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 das interfaces do usuário estiver disponível, a função retornará E_NOTIMPL.

 

hwndParent

Digite: HWND

Especifica o identificador para a janela pai da caixa de diálogo.

bstrFolderName

Tipo: BSTR

Especifica o nome da pasta para onde os arquivos são transferidos.

bstrFilename

Tipo: BSTR

Especifica o modelo de nome de arquivo a ser usado para arquivos transferidos de itens WIA para a pasta de destino designada por bstrFolderName. Um número arbitrário de nomes de arquivo exclusivos pode ser criado acrescentando caracteres adicionais ao modelo de nome de arquivo.

lNumFiles

Tipo: LONG

Recebe o número de cadeias de caracteres gravadas na matriz pbstrFilePaths .

pbstrFilePaths

Tipo: BSTR*

Ponteiro para uma matriz de ponteiros BSTR. Cada elemento de matriz aponta para um BSTR que contém o nome de destino de um arquivo que foi transferido com êxito para a pasta identificada por bstrFolderName. O método deve alocar o armazenamento para esse membro.

ppWiaItem

Tipo: IWiaItem2*

Ponteiro para a interface IWiaItem2 do item WIA que transfere dados para o arquivo ou arquivos nomeados na matriz pbstrFilePaths .

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	Wiadefd.h