FILEDESCRIPTORA-Struktur (shlobj_core.h)

  • Artikel

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