Struttura FILEDESCRIPTORA (shlobj_core.h)

Descrive le proprietà di un file copiato tramite gli Appunti durante un'operazione di trascinamento della selezione di Microsoft ActiveX.

Sintassi

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;

Members

dwFlags

Tipo: DWORD

Matrice di flag che indicano quale degli altri membri della struttura contengono dati validi. Questo membro può essere una combinazione dei valori seguenti.

FD_CLSID (0x00000001)

0x00000001. Il membro clsid è valido.

FD_SIZEPOINT (0x00000002)

0x00000002. I membri sizel e pointl sono validi.

FD_ATTRIBUTES (0x00000004)

0x00000004. Il membro dwFileAttributes è valido.

FD_CREATETIME (0x00000008)

0x00000008. Il membro ftCreationTime è valido.

FD_ACCESSTIME (0x00000010)

0x00000010. Il membro ftLastAccessTime è valido.

FD_WRITESTIME (0x00000020)

0x00000020. Il membro ftLastWriteTime è valido.

FD_FILESIZE (0x00000040)

0x00000040. I membri nFileSizeHigh e nFileSizeLow sono validi.

FD_PROGRESSUI (0x00004000)

0x00004000. Viene visualizzato un indicatore di stato con operazioni di trascinamento della selezione.

FD_LINKUI (0x00008000)

0x00008000. Considerare l'operazione come collegamento.

FD_UNICODE ((int)0x80000000)

(int)0x80000000. Windows Vista e versioni successive. Il descrittore è Unicode.

clsid

Tipo: CLSID

Identificatore del tipo di file.

sizel

Tipo: SIZEL

Larghezza e altezza dell'icona del file.

pointl

Tipo: POINTL

Coordinate dello schermo dell'oggetto file.

dwFileAttributes

Tipo: DWORD

Flag di attributo file. Si tratta di una combinazione dei valori FILE_ATTRIBUTE_ descritti in GetFileAttributes.

ftCreationTime

Tipo: FILETIME

Struttura FILETIME che contiene l'ora di creazione del file.

ftLastAccessTime

Tipo: FILETIME

Struttura FILETIME che contiene l'ora dell'ultimo accesso al file.

ftLastWriteTime

Tipo: FILETIME

Struttura FILETIME contenente l'ora dell'ultima operazione di scrittura.

nFileSizeHigh

Tipo: DWORD

DWORD di ordine elevato delle dimensioni del file, in byte.

nFileSizeLow

Tipo: DWORD

DWORD di ordine basso delle dimensioni del file, in byte.

cFileName[MAX_PATH]

Tipo: TCHAR[MAX_PATH]

Stringa con terminazione Null contenente il nome del file.

Commenti

Se il formato CFSTR_FILECONTENTS che corrisponde a questa struttura contiene il file come oggetto memoria globale, nFileSizeHigh e nFileSizeLow specificano le dimensioni del blocco di memoria associato. Se sono impostati, possono essere usati anche se è necessario visualizzare un'interfaccia utente. Ad esempio, se un file sta per essere sovrascritto, in genere si userebbero le informazioni di questa struttura per visualizzare una finestra di dialogo contenente le dimensioni, i dati e il nome del file.

Per creare un file di lunghezza zero, impostare il flag FD_FILESIZE in dwFlags e impostare nFileSizeHigh e nFileSizeLow su zero. Il formato CFSTR_FILECONTENTS deve rappresentare il file come oggetto flusso o memoria globale (TYMED_ISTREAM o TYMED_HGLOBAL).

Nota

L'intestazione shlobj_core.h definisce FILEDESCRIPTOR come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	shlobj_core.h