Freigeben über

FILEDESCRIPTORA-Struktur (shlobj_core.h)

  • Artikel

Beschreibt die Eigenschaften einer Datei, die mithilfe der Zwischenablage während eines Microsoft ActiveX-Drag-and-Drop--Vorgangs 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;

Angehörige

dwFlags

Typ: DWORD-

Ein Array von Flags, die angeben, welche der anderen Strukturmmber gültige Daten enthalten. Dieses Element kann eine Kombination aus den folgenden Werten sein.

FD_CLSID (0x00000001)

0x00000001. Das clsid Member ist gültig.

FD_SIZEPOINT (0x00000002)

0x00000002. Die sizel und Pointl Member sind gültig.

FD_ATTRIBUTES (0x00000004)

0x00000004. Das dwFileAttributes Member ist gültig.

FD_CREATETIME (0x00000008)

0x00000008. Das ftCreationTime Member ist gültig.

FD_ACCESSTIME (0x00000010)

0x00000010. Das ftLastAccessTime- Mitglied ist gültig.

FD_WRITESTIME (0x00000020)

0x00000020. Das ftLastWriteTime Member ist gültig.

FD_FILESIZE (0x00000040)

0x00000040. Die nFileSizeHigh und nFileSizeLow Member 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

Typ: DWORD-

Datei-Attributkennzeichnungen. Dies ist eine Kombination der in GetFileAttributesbeschriebenen 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 die Datei zuletzt zugegriffen wurde.

ftLastWriteTime

Typ: FILETIME-

Die FILETIME- Struktur, die den Zeitpunkt des letzten Schreibvorgangs enthält.

nFileSizeHigh

Typ: DWORD-

Die hohe Reihenfolge DWORD- der Dateigröße in Byte.

nFileSizeLow

Typ: DWORD-

Die niedrige Reihenfolge DWORD- der Dateigröße in Byte.

cFileName[MAX_PATH]

Typ: TCHAR[MAX_PATH]

Die mit Null beendete Zeichenfolge, die den Namen der Datei enthält.

Bemerkungen

Wenn das CFSTR_FILECONTENTS Format, das dieser Struktur entspricht, die Datei als globales Speicherobjekt enthält, nFileSizeHigh und nFileSizeLow die Größe des zugeordneten Speicherblocks angeben. Wenn sie festgelegt sind, können sie auch verwendet werden, wenn eine Benutzeroberfläche angezeigt werden muss. Wenn beispielsweise eine Datei überschrieben werden soll, würden Sie in der Regel Informationen aus dieser Struktur verwenden, um ein Dialogfeld mit der Größe, den Daten und dem Namen der Datei anzuzeigen.

Zum Erstellen einer Datei mit null Länge legen Sie das FD_FILESIZE Flag im dwFlags-fest, und legen Sie nFileSizeHigh und nFileSizeLow auf Null fest. Das CFSTR_FILECONTENTS Format sollte die Datei entweder als Datenstrom- oder globales Speicherobjekt (TYMED_ISTREAM oder TYMED_HGLOBAL) darstellen.

Anmerkung

Der header shlobj_core.h 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
mindestens unterstützte Client- Windows XP [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Header- shlobj_core.h