Estructura DEVICEDIALOGDATA2

Define los datos necesarios para llamar a un cuadro de diálogo de dispositivo.

Sintaxis

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

Miembros

cbSize

Tipo: DWORD

Especifica el tamaño de esta estructura en bytes.

pIWiaItemRoot

Tipo: IWiaItem2*

Apunta a una interfaz IWiaItem2 que representa el elemento raíz válido en el árbol de elementos de aplicación.

dwFlags

Tipo: DWORD

Especifica un conjunto de marcas que controlan la operación del cuadro de diálogo. Se puede establecer en cualquiera de los valores siguientes:

Marca	Significado
0	Comportamiento predeterminado.
WIA_DEVICE_DIALOG_SINGLE_IMAGE	Restrinja la selección de imágenes a una sola imagen en el cuadro de diálogo de adquisición de imágenes de dispositivo.
WIA_DEVICE_DIALOG_USE_COMMON_UI	Use la interfaz de usuario del sistema, si está disponible, en lugar de la interfaz de usuario proporcionada por el proveedor. Si la interfaz de usuario del sistema no está disponible, se usa la interfaz de usuario del proveedor. Si ninguna interfaz de usuario está disponible, la función devuelve E_NOTIMPL.

 

hwndParent

Tipo: HWND

Especifica el identificador de la ventana primaria del cuadro de diálogo.

bstrFolderName

Tipo: BSTR

Especifica el nombre de la carpeta donde se transfieren los archivos.

bstrFilename

Tipo: BSTR

Especifica la plantilla de nombre de archivo que se va a usar para los archivos transferidos de elementos WIA a la carpeta de destino designada por bstrFolderName. Se puede crear un número arbitrario de nombres de archivo únicos anexando caracteres adicionales a la plantilla de nombre de archivo.

lNumFiles

Tipo: LONG

Recibe el número de cadenas escritas en la matriz pbstrFilePaths .

pbstrFilePaths

Tipo: BSTR*

Puntero a una matriz de punteros BSTR. Cada elemento de matriz apunta a un BSTR que contiene el nombre de destino de un archivo que se transfirió correctamente a la carpeta identificada por bstrFolderName. El método debe asignar el almacenamiento para este miembro.

ppWiaItem

Tipo: IWiaItem2*

Puntero a la interfaz IWiaItem2 del elemento WIA que transfiere datos al archivo o archivos denominados en la matriz pbstrFilePaths .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Wiadefd.h