MARK_HANDLE_INFO-Struktur (ntifs.h)
Eine MARK_HANDLE_INFO-Struktur wird während einer FSCTL_MARK_HANDLE-Steuerelementcodeanforderung als Eingabepuffer übergeben.
Syntax
typedef struct _MARK_HANDLE_INFO {
union {
ULONG UsnSourceInfo;
ULONG CopyNumber;
} DUMMYUNIONNAME;
ULONG UsnSourceInfo;
HANDLE VolumeHandle;
ULONG HandleInfo;
} MARK_HANDLE_INFO, *PMARK_HANDLE_INFO;
Member
DUMMYUNIONNAME
DUMMYUNIONNAME.UsnSourceInfo
Siehe UsnSourceInfo unten.
DUMMYUNIONNAME.CopyNumber
Gibt an, welche Kopie einer Datei gelesen werden soll, wenn sie aus einer Datei liest, die sich auf redundanten Medien befindet.
UsnSourceInfo
Die optionalen USN-Quellinformationsflags (Update Sequence Number). Um einen dieser Werte festzulegen, muss im VolumeHandle-Feld ein Volume-DASD-Handle angegeben werden. Kann eine Kombination der folgenden Werte sein:
| Flag | Bedeutung |
|---|---|
| USN_SOURCE_DATA_MANAGEMENT | Der Dienst ändert die externe Ansicht von keinem Teil der Datei. Ein typischer Fall ist die HSM-Verschiebung von Daten in und aus externem Speicher. |
| USN_SOURCE_AUXILIARY_DATA | Der Dienst ändert die externe Ansicht der Datei nicht in Bezug auf die Anwendung, die diese Datei erstellt hat. Kann verwendet werden, um einer Datei private Datenströme hinzuzufügen. |
| USN_SOURCE_REPLICATION_MANAGEMENT | Der Dienst ändert eine Datei so, dass sie dem Inhalt derselben Datei entspricht, die in einem anderen Element des Replikatsatzes vorhanden ist. |
| USN_SOURCE_CLIENT_REPLICATION_MANAGEMENT | Die Replikation wird auf Clientsystemen entweder aus der Cloud oder von Servern ausgeführt. Ein Volumehandle ist nicht erforderlich, um diesen Wert festzulegen. |
VolumeHandle
Volumehandle für diesen Vorgang.
HandleInfo
Enthält Flags zum Identifizieren der Anforderung. Dieses Feld kann einer der folgenden Werte sein:
| Flag | Bedeutung |
|---|---|
| MARK_HANDLE_PROTECT_CLUSTERS | Lassen Sie keine Defragmentierung (FSCTL_MOVE_FILE) zu, bis das Handle geschlossen ist. |
| MARK_HANDLE_TXF_SYSTEM_LOG | Dieser Stream wird als Txf-Protokoll für einen Ressourcen-Manager auf dem Volume verwendet. Muss im Kernel mit IRP_MN_KERNEL_CALL aufgerufen werden. Verfügbar ab Windows Vista. |
| MARK_HANDLE_NOT_TXF_SYSTEM_LOG | Diese Komponente verwendet dieses Objekt nicht mehr als TxF-Protokolldatei. Verfügbar ab Windows Vista. |
| MARK_HANDLE_REALTIME | Wird nur vom UDFS-Dateisystem unterstützt. Markiert das Gerät für das Echtzeitstreaming von Videos. Verfügbar ab Windows 7. |
| MARK_HANDLE_NOT_REALTIME | Wird nur vom UDFS-Dateisystem unterstützt. Markiert das Gerät so, dass kein Echtzeitstreaming von Videos mehr ausgeführt wird. Verfügbar ab Windows 7. |
| MARK_HANDLE_CLOUD_SYNC | Veraltet; Verwenden Sie dieses Flag nicht. |
| MARK_HANDLE_READ_COPY | Die Daten müssen aus der angegebenen Kopie der Daten gelesen werden. Nur für Speicherplätze redundante Volumes unterstützt. Verfügbar ab Windows 8. |
| MARK_HANDLE_NOT_READ_COPY | Die Daten sind nicht mehr aus einer bestimmten Kopie zu lesen. Nur für Speicherplätze redundante Volumes unterstützt. Verfügbar ab Windows 8. |
| MARK_HANDLE_FILTER_METADATA | Nur für die interne Verwendung von Microsoft reserviert. |
| MARK_HANDLE_RETURN_PURGE_FAILURE | Beim Mischen von zugeordneten/zwischengespeicherten E/A mit nicht zwischengespeicherten E/A/A und einer nicht zwischengespeicherten E/A-E/A versucht das System, Speicherzuordnungen für den Bereich der nicht zwischengespeicherten E/A zu bereinigen. Wenn diese Bereinigungen fehlschlagen, gibt das System den Fehler normalerweise nicht an den Aufrufer zurück, was zu einem beschädigten Zustand führen kann. Dieses Flag weist das System an, Löschfehler für den angegebenen Handle zurückzugeben, damit die Anwendung diese Situation besser bewältigen kann. Verfügbar ab Windows 8.1. |
| MARK_HANDLE_DISABLE_FILE_METADATA_OPTIMIZATION | Deaktiviert die FrS-Komprimierungsfunktion (File Replication Service) für die angegebene Datei. Verfügbar ab Windows 10 Version 1507. |
| MARK_HANDLE_ENABLE_USN_SOURCE_ON_PAGING_IO | Weist NTFS an, den angegebenen UsnSourceInfo-Wert für Pagingschreibvorgänge im USN-Journal festzulegen. Traditionell wurde dies nicht beim Paging von Schreibvorgängen durchgeführt, da Sie nicht wussten, welcher Thread die angegebenen Änderungen vorgenommen hat. Dies ist eine Überschreibung. Dies funktioniert nur, wenn dem FileObject, für das der Speicher-Manager hält, dieser Zustand zugeordnet ist. Verfügbar ab Windows 10 Version 1507. |
| MARK_HANDLE_SKIP_COHERENCY_SYNC_DISALLOW_WRITES | Teilt dem System mit, dass Schreibvorgänge für diese Datei nicht zulässig sind. Wenn jemand versucht, die Datei für den Schreibzugriff zu öffnen, ist der Vorgang mit STATUS_ACCESS_DENIED fehlgeschlagen. Wenn ein Schreibvorgang angezeigt wird, ist der Vorgang mit STATUS_MARKED_TO_DISALLOW_WRITES fehlgeschlagen. Verfügbar ab Windows 10 Version 1507. |
| MARK_HANDLE_ENABLE_CPU_CACHE | Nur für die interne Verwendung von Microsoft reserviert. |
| MARK_HANDLE_SUPPRESS_VOLUME_OPEN_FLUSH | Normalerweise löscht das Dateisystem beim ersten Lese-/Schreibvorgang auf einem Volumehandle (DASD geöffnet) das Volume. Dies kann in bestimmten Szenarien Auswirkungen auf die Leistung haben. Wenn dieses Flag für ein Volumehandle festgelegt ist, wird diese Leerung bei der ersten E/A unterdrückt. Verfügbar ab Windows 11. |
Hinweise
MARK_HANDLE_INFO enthält die Informationen, die zum Markieren einer angegebenen Datei oder eines angegebenen Verzeichnisses verwendet werden, und den Änderungsjournaleintrag der Updatesequenznummer (USN) mit Daten zu Änderungen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP |
| Kopfzeile | ntifs.h |