FILEDESCRIPTORA-Struktur (shlobj_core.h)
Beschreibt die Eigenschaften einer Datei, die während eines Microsoft ActiveX-Drag-and-Drop-Vorgangs mithilfe der Zwischenablage kopiert wird.
Syntax
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;
Member
dwFlags
Art: DWORD
Ein Array von Flags, die angeben, welche der anderen Strukturmember gültige Daten enthalten. Dieser Member kann eine Kombination der folgenden Werte sein.
FD_CLSID (0x00000001)
0x00000001. Das clsid-Element ist gültig.
FD_SIZEPOINT (0x00000002)
0x00000002. Die Member sizel und pointl sind gültig.
FD_ATTRIBUTES (0x00000004)
0x00000004. Das dwFileAttributes-Element ist gültig.
FD_CREATETIME (0x00000008)
0x00000008. Das ftCreationTime-Element ist gültig.
FD_ACCESSTIME (0x00000010)
0x00000010. Das ftLastAccessTime-Element ist gültig.
FD_WRITESTIME (0x00000020)
0x00000020. Das ftLastWriteTime-Element ist gültig.
FD_FILESIZE (0x00000040)
0x00000040. Die Member nFileSizeHigh und nFileSizeLow sind gültig.
FD_PROGRESSUI (0x00004000)
0x00004000. Eine Statusanzeige wird mit Drag-and-Drop-Vorgängen angezeigt.
FD_LINKUI (0x00008000)
0x00008000. Behandeln Sie den Vorgang als Verknüpfung.
FD_UNICODE ((int)0x80000000)
(int)0x80000000. Windows Vista und höher. Der Deskriptor ist Unicode.
clsid
Typ: CLSID
Der Dateitypbezeichner.
sizel
Typ: SIZEL
Die Breite und Höhe des Dateisymbols.
pointl
Typ: POINTL
Die Bildschirmkoordinaten des Dateiobjekts.
dwFileAttributes
Art: DWORD
Dateiattributeflags. Dies ist eine Kombination der in GetFileAttributes beschriebenen FILE_ATTRIBUTE_ Werte.
ftCreationTime
Typ: FILETIME
Die FILETIME-Struktur , die den Zeitpunkt der Dateierstellung enthält.
ftLastAccessTime
Typ: FILETIME
Die FILETIME-Struktur , die den Zeitpunkt enthält, zu dem zuletzt auf die Datei zugegriffen wurde.
ftLastWriteTime
Typ: FILETIME
Die FILETIME-Struktur , die den Zeitpunkt des letzten Schreibvorgangs enthält.
nFileSizeHigh
Art: DWORD
Die hohe DWORD-Reihenfolge der Dateigröße in Byte.
nFileSizeLow
Art: DWORD
Der DWORD-Wert in niedriger Reihenfolge der Dateigröße in Byte.
cFileName[MAX_PATH]
Typ: TCHAR[MAX_PATH]
Die NULL-Zeichenfolge, die den Namen der Datei enthält.
Hinweise
Wenn das CFSTR_FILECONTENTS Format, das dieser Struktur entspricht, die Datei als globales Speicherobjekt enthält, geben nFileSizeHigh und nFileSizeLow die Größe des zugeordneten Speicherblocks an. Wenn sie festgelegt sind, können sie auch verwendet werden, wenn eine Benutzeroberfläche angezeigt werden muss. Wenn eine Datei beispielsweise überschrieben werden soll, verwenden Sie in der Regel Informationen aus dieser Struktur, um ein Dialogfeld anzuzeigen, das die Größe, die Daten und den Namen der Datei enthält.
Um eine Datei der Länge Null zu erstellen, legen Sie das flag FD_FILESIZE in dwFlags und nFileSizeHigh und nFileSizeLow auf null fest. Das CFSTR_FILECONTENTS-Format sollte die Datei entweder als Stream oder als globales Speicherobjekt (TYMED_ISTREAM oder TYMED_HGLOBAL) darstellen.
Hinweis
Der shlobj_core.h-Header definiert FILEDESCRIPTOR als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Kopfzeile | shlobj_core.h |