Estructura FILEDESCRIPTORA (shlobj_core.h)

Describe las propiedades de un archivo que se copia mediante el Portapapeles durante una operación de arrastrar y colocar de Microsoft ActiveX .

Sintaxis

typedef struct _FILEDESCRIPTORA {
  DWORD    dwFlags;
  CLSID    clsid;
  SIZEL    sizel;
  POINTL   pointl;
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
  CHAR     cFileName[MAX_PATH];
} FILEDESCRIPTORA, *LPFILEDESCRIPTORA;

Miembros

dwFlags

Tipo: DWORD de

Matriz de marcas que indican cuáles de los otros miembros de la estructura contienen datos válidos. Este miembro puede ser una combinación de los valores siguientes.

FD_CLSID (0x00000001)

0x00000001. El miembro clsid es válido.

FD_SIZEPOINT (0x00000002)

0x00000002. Los miembros y pointl de son válidos.

FD_ATTRIBUTES (0x00000004)

0x00000004. El miembro dwFileAttributes es válido.

FD_CREATETIME (0x00000008)

0x00000008. El miembro ftCreationTime es válido.

FD_ACCESSTIME (0x00000010)

0x00000010. El miembro ftLastAccessTime es válido.

FD_WRITESTIME (0x00000020)

0x00000020. El miembro ftLastWriteTime es válido.

FD_FILESIZE (0x00000040)

0x00000040. Los nFileSizeHigh de y nFileSizeLow son válidos.

FD_PROGRESSUI (0x00004000)

0x00004000. Se muestra un indicador de progreso con operaciones de arrastrar y colocar.

FD_LINKUI (0x00008000)

0x00008000. Trate la operación como acceso directo.

FD_UNICODE ((int)0x80000000)

(int)0x80000000. Windows Vista y versiones posteriores. El descriptor es Unicode.

clsid

Tipo: CLSID

Identificador de tipo de archivo.

sizel

Tipo: SIZEL de

Ancho y alto del icono de archivo.

pointl

Tipo: POINTL de

Coordenadas de pantalla del objeto de archivo.

dwFileAttributes

Tipo: DWORD de

Marcas de atributo de archivo. Esta será una combinación de los valores de FILE_ATTRIBUTE_ descritos en GetFileAttributes.

ftCreationTime

Tipo: FILETIME de

Estructura FILETIME que contiene la hora de creación del archivo.

ftLastAccessTime

Tipo: FILETIME de

Estructura FILETIME que contiene la hora a la que se accedió por última vez al archivo.

ftLastWriteTime

Tipo: FILETIME de

Estructura FILETIME que contiene la hora de la última operación de escritura.

nFileSizeHigh

Tipo: DWORD de

El DWORD de orden superior del tamaño de archivo, en bytes.

nFileSizeLow

Tipo: DWORD de

El DWORD de orden bajo del tamaño del archivo, en bytes.

cFileName[MAX_PATH]

Tipo: TCHAR[MAX_PATH]

Cadena terminada en null que contiene el nombre del archivo.

Observaciones

Si el formato CFSTR_FILECONTENTS que corresponde a esta estructura contiene el archivo como un objeto de memoria global, nFileSizeHigh y nFileSizeLow especifique el tamaño del bloque de memoria asociado. Si se establecen, también se pueden usar si es necesario mostrar una interfaz de usuario. Por ejemplo, si un archivo está a punto de sobrescribirse, normalmente usaría información de esta estructura para mostrar un cuadro de diálogo que contenga el tamaño, los datos y el nombre del archivo.

Para crear un archivo de longitud cero, establezca la marca FD_FILESIZE en el dwFlagsy establezca nFileSizeHigh y nFileSizeLow en cero. El formato CFSTR_FILECONTENTS debe representar el archivo como un objeto de secuencia o memoria global (TYMED_ISTREAM o TYMED_HGLOBAL).

Nota

El encabezado shlobj_core.h define FILEDESCRIPTOR como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
encabezado de	shlobj_core.h