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;
Angehörige
DUMMYUNIONNAME
DUMMYUNIONNAME.UsnSourceInfo
Siehe UsnSourceInfo- unten.
DUMMYUNIONNAME.CopyNumber
Gibt an, welche Kopie einer zu lesenden Datei beim Lesen aus einer Datei, die sich auf redundanten Medien befindet.
UsnSourceInfo
Die optionalen USN-Quellinformationskennzeichnungen (Update Sequence Number). Um einen dieser Werte festzulegen, muss ein Volume-DASD-Handle im feld VolumeHandle angegeben werden. Dies kann eine Kombination der folgenden Werte sein:
| Flagge | Bedeutung |
|---|---|
| USN_SOURCE_DATA_MANAGEMENT | Der Dienst ändert die externe Ansicht eines Teils der Datei nicht. Typisch ist, dass HSM Daten in und aus externem Speicher verschiebt. |
| USN_SOURCE_AUXILIARY_DATA | Der Dienst ändert nicht die externe Ansicht der Datei 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 der Replikatmenge vorhanden ist. |
| USN_SOURCE_CLIENT_REPLICATION_MANAGEMENT | Die Replikation wird auf Clientsystemen entweder über die Cloud oder server 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 einen der folgenden Werte aufweisen:
| Flagge | Bedeutung |
|---|---|
| MARK_HANDLE_PROTECT_CLUSTERS | Lassen Sie keine Defragmentierung (FSCTL_MOVE_FILE) zu, bis der Handle geschlossen wird. |
| MARK_HANDLE_TXF_SYSTEM_LOG | Dieser Datenstrom wird als Txf-Protokoll für einen Ressourcen-Manager auf dem Volume verwendet. Muss im Kernel mithilfe von 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, um das Echtzeitstreaming von Video zu erledigen. Verfügbar ab Windows 7. |
| MARK_HANDLE_NOT_REALTIME | Wird nur vom UDFS-Dateisystem unterstützt. Markiert das Gerät, damit das Video nicht mehr in Echtzeit gestreamt 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 Datenkopie gelesen werden. Wird nur für redundante Speicherplätze unterstützt. Verfügbar ab Windows 8. |
| MARK_HANDLE_NOT_READ_COPY | Die Daten werden nicht mehr aus einer bestimmten Kopie gelesen. Wird nur für redundante Speicherplätze unterstützt. Verfügbar ab Windows 8. |
| MARK_HANDLE_FILTER_METADATA | Nur für interne Microsoft-Verwendung reserviert. |
| MARK_HANDLE_RETURN_PURGE_FAILURE | Wenn die Kopplung des zugeordneten/zwischengespeicherten Speichers mit nicht zwischengespeicherter E/A-Datei und einer nicht zwischengespeicherten E/A ausgegeben wird, versucht das System, Speicherzuordnungen für den Bereich der nicht zwischengespeicherten E/A zu löschen. Wenn diese Bereinigungen fehlschlagen, gibt das System normalerweise nicht den Fehler an den Aufrufer zurück, der zu beschädigten Zustand führen kann. Dieses Kennzeichen weist das System an, Löschfehler für das angegebene Handle zurückzugeben, damit die Anwendung diese Situation besser behandeln kann. Verfügbar ab Windows 8.1. |
| MARK_HANDLE_DISABLE_FILE_METADATA_OPTIMIZATION | Deaktiviert die Komprimierungsfunktion (File Record Segment, FRS) 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 Paging-Schreibvorgänge im USN Journal festzulegen. Dies wurde traditionell nicht bei Seitenerstellungs-Schreibvorgängen durchgeführt, da Sie nicht wissen, welcher Thread die gegebenen Änderungen vorgenommen hat. Dies ist eine Außerkraftsetzung. Dies funktioniert nur, wenn das FileObject, das der Speicher-Manager hält, diesen Zustand zugeordnet hat. Verfügbar ab Windows 10, Version 1507. |
| MARK_HANDLE_SKIP_COHERENCY_SYNC_DISALLOW_WRITES | Teilt dem System mit, dass Schreibvorgänge in dieser 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 mit STATUS_MARKED_TO_DISALLOW_WRITES fehlgeschlagen ist. Verfügbar ab Windows 10, Version 1507. |
| MARK_HANDLE_ENABLE_CPU_CACHE | Nur für interne Microsoft-Verwendung reserviert. |
| MARK_HANDLE_SUPPRESS_VOLUME_OPEN_FLUSH | Normalerweise löscht das Dateisystem beim ersten Lese-/Schreibvorgang auf einem Volumehandle (DASD open) das Volume. Dies kann auswirkungen auf die Leistung in bestimmten Szenarien haben. Wenn dieses Flag für einen Volumehandle festgelegt ist, wird diese Leerung bei der ersten E/A unterdrückt. Verfügbar ab Windows 11. |
Bemerkungen
MARK_HANDLE_INFO enthält die Informationen, die verwendet werden, um eine angegebene Datei oder ein angegebenes Verzeichnis zu markieren, und die Aktualisierungssequenznummer (USN) ändert den Journaldatensatz mit Daten zu Änderungen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP |
| Header- | ntifs.h |