Struttura FILEDESCRIPTORA (shlobj_core.h)

Descrive le proprietà di un file copiato tramite gli Appunti durante un'operazione di trascinamento della selezione 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;

Membri

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 e sizel 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 nFileSizeHi ghHigh 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 di file. Questa sarà una combinazione dei valori di 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 che contiene l'ora dell'ultima operazione di scrittura.

nFileSizeHigh

Tipo: DWORD

Ordine elevato DWORD delle dimensioni del file, in byte.

nFileSizeLow

Tipo: DWORD

L' DWORD in ordine basso delle dimensioni del file, in byte.

cFileName[MAX_PATH]

Tipo: TCHAR[MAX_PATH]

Stringa con terminazione Null contenente il nome del file.

Osservazioni

Se il formato CFSTR_FILECONTENTS corrispondente a questa struttura contiene il file come oggetto memoria globale, nFileSizeHigh e nFileSizeLow specificare 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 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 di FD_FILESIZE nel dwFlagse impostare nFileSizeHigh e nFileSizeLow su zero. Il formato CFSTR_FILECONTENTS deve rappresentare il file come un oggetto di memoria globale o di flusso (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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	shlobj_core.h