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 |