SHCOLUMNDATA-Struktur (shlobj.h)
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 |