SHCOLUMNDATA-Struktur (shlobj.h)

  • Artikel

Enthält Informationen, die eine bestimmte Datei identifizieren. Es wird von IColumnProvider::GetItemData verwendet, wenn Daten für eine bestimmte Datei angefordert werden.

Syntax

typedef struct {
  ULONG dwFlags;
  DWORD dwFileAttributes;
  ULONG dwReserved;
  WCHAR *pwszExt;
  WCHAR wszFile[MAX_PATH];
} SHCOLUMNDATA, *LPSHCOLUMNDATA;

Member

dwFlags

Typ: ULONG

Flags, die verwendet werden, um die Art der Anforderung anzugeben.

SHCDF_UPDATEITEM

Die von wszFile angegebene Datei ist eine neue Datei oder eine Datei, die sich seit dem letzten Aufruf von IColumnProvider::GetItemData geändert hat. Alle zwischengespeicherten Daten sollten geleert und neu berechnet werden. Spaltenhandler, die keine Daten zwischenspeichern oder daten anzeigen, die getrennt von der Datei gespeichert sind, können dieses Flag ignorieren.

dwFileAttributes

Art: DWORD

Dateiattributeflags. Dies ist einer oder mehrere der folgenden Werte.

FILE_ATTRIBUTE_ARCHIVE

Die Datei oder das Verzeichnis ist eine Archivdatei oder ein Verzeichnis. Anwendungen verwenden dieses Attribut, um Dateien für die Sicherung oder Entfernung zu markieren.

FILE_ATTRIBUTE_COMPRESSED

Die Datei oder das Verzeichnis wird komprimiert. Für eine Datei bedeutet dies, dass alle Daten in der Datei komprimiert sind. Für ein Verzeichnis bedeutet dies, dass die Komprimierung die Standardeinstellung für neu erstellte Dateien und Unterverzeichnisse ist.

FILE_ATTRIBUTE_DIRECTORY

Das Handle identifiziert ein Verzeichnis.

FILE_ATTRIBUTE_ENCRYPTED

Die Datei oder das Verzeichnis ist verschlüsselt. Für eine Datei bedeutet dies, dass alle Datenströme in der Datei verschlüsselt sind. Für ein Verzeichnis bedeutet dies, dass die Verschlüsselung die Standardeinstellung für neu erstellte Dateien und Unterverzeichnisse ist.

FILE_ATTRIBUTE_HIDDEN

Die Datei oder das Verzeichnis ist versteckt. Die Datei ist ausgeblendet und daher nicht in einer normalen Verzeichnisliste enthalten.

FILE_ATTRIBUTE_NORMAL

Für die Datei oder das Verzeichnis wurden keine anderen Attribute festgelegt. Dieses Attribut ist nur gültig, wenn es allein verwendet wird.

FILE_ATTRIBUTE_OFFLINE

Die Daten der Datei sind nicht sofort verfügbar. Dieses Attribut gibt an, dass die Dateidaten physisch in den Offlinespeicher verschoben wurden. Dieses Attribut wird von Remote storage verwendet, der hierarchischen Speicherverwaltungssoftware in Windows 2000. Wenn dieses Attribut festgelegt ist, sollte der Spaltenhandler das Öffnen der Datei vermeiden, da dies dazu führt, dass die Datei aus dem Offlinespeicher abgerufen wird.

FILE_ATTRIBUTE_READONLY

Die Datei oder das Verzeichnis ist schreibgeschützt. Anwendungen können die Datei lesen, aber nicht in sie schreiben oder löschen. Im Fall eines Verzeichnisses können Anwendungen es nicht löschen.

FILE_ATTRIBUTE_REPARSE_POINT

Die Datei verfügt über einen zugeordneten Analysepunkt.

FILE_ATTRIBUTE_SPARSE_FILE

Die Datei ist eine Datei mit geringer Dichte.

FILE_ATTRIBUTE_SYSTEM

Die Datei oder das Verzeichnis ist Teil des Betriebssystems oder wird ausschließlich von diesem verwendet.

FILE_ATTRIBUTE_TEMPORARY

Die Datei wird für den temporären Speicher verwendet. Dateisysteme versuchen alle Daten für einen schnelleren Zugriff im Speicher zu behalten, anstatt diese zurück in den Massenspeicher zu entleeren. Eine temporäre Datei sollte von der Anwendung gelöscht werden, sobald sie nicht mehr benötigt wird.

dwReserved

Typ: ULONG

Reserviert. Auf NULL festgelegt.

pwszExt

Typ: WCHAR*

Ein Zeiger auf eine mit NULL endende Unicode-Zeichenfolge mit einer Dateinamenerweiterung.

wszFile[MAX_PATH]

Typ: WCHAR[MAX_PATH]

Eine mit NULL endende Unicode-Zeichenfolge, die einen vollqualifizierten Dateipfad enthält.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile shlobj.h

Weitere Informationen

GetFileAttributes