ATOMIC_CREATE_ECP_CONTEXT-Struktur (ntifs.h)

Die ATOMIC_CREATE_ECP_CONTEXT-Struktur enthält den ECP-Kontext (Extra Create Parameter), mit dem zusätzliche Vorgänge für eine Datei während der Erstellung atomar ausgeführt werden können.

Syntax

typedef struct _ATOMIC_CREATE_ECP_CONTEXT {
  USHORT               Size;
  USHORT               InFlags;
  USHORT               OutFlags;
  USHORT               ReparseBufferLength;
  PREPARSE_DATA_BUFFER ReparseBuffer;
  LONGLONG             FileSize;
  LONGLONG             ValidDataLength;
  PFILE_TIMESTAMPS     FileTimestamps;
  ULONG                FileAttributes;
  ULONG                UsnSourceInfo;
  USN                  Usn;
  ULONG                SuppressFileAttributeInheritanceMask;
  ULONG                InOpFlags;
  ULONG                OutOpFlags;
  ULONG                InGenFlags;
  ULONG                OutGenFlags;
  ULONG                CaseSensitiveFlagsMask;
  ULONG                InCaseSensitiveFlags;
  ULONG                OutCaseSensitiveFlags;
} ATOMIC_CREATE_ECP_CONTEXT, *PATOMIC_CREATE_ECP_CONTEXT;

Member

Size

Die Größe dieser Kontextstruktur in Bytes.

InFlags

Flags, die die angeforderten zusätzlichen Vorgänge angeben, die mit dem Erstellungsvorgang ausgeführt werden sollen.

Wert	Bedeutung
ATOMIC_CREATE_ECP_IN_FLAG_SPARSE_SPECIFIED	Fordert an, dass das Sparseflag für die Datei festgelegt wird.
ATOMIC_CREATE_ECP_IN_FLAG_REPARSE_POINT_SPECIFIED	Fordert an, dass ein Analysepunkt für die Datei festgelegt wird.
ATOMIC_CREATE_ECP_IN_FLAG_EOF_SPECIFIED	Fordert an, dass eine Dateigröße für die Datei festgelegt wird. Dies impliziert auch
dass die Zuordnung auf dem Datenträger erfolgt, um die angeforderte Dateigröße zu unterstützen.
ATOMIC_CREATE_ECP_IN_FLAG_VDL_SPECIFIED	Fordert an, dass eine gültige Datenlänge für die Datei festgelegt wird. Dies bedeutet auch, dass die Dateigröße auf mindestens die angeforderte gültige Datenlänge festgelegt wird. HINWEIS: Dies gilt als privilegierter Vorgang, wenn er möglicherweise
nicht initialisierte Daten verfügbar machen.
ATOMIC_CREATE_ECP_IN_FLAG_OPERATION_MASK	Verwenden Sie dieses Flag als Maske, um die anderen InFlags-Flagwerte anzugeben.
ATOMIC_CREATE_ECP_IN_FLAG_BEST_EFFORT	Gibt an, dass das Dateisystem den Erstellungsvorgang auch dann ausführen soll, wenn einige der angeforderten zusätzlichen Vorgänge nicht ausgeführt werden konnten.
ausgeführt oder werden vom Dateisystem nicht unterstützt. Der Aufrufer kann OutFlags überprüfen, um zu sehen, welche Vorgänge ausgeführt wurden. Wenn dieses Flag nicht angegeben ist, sollte das Dateisystem den Erstellungsvorgang nicht erfolgreich ausführen, wenn es nicht alle angeforderten zusätzlichen Vorgänge erfolgreich ausführen kann.

OutFlags

Flags, die die tatsächlichen zusätzlichen Vorgänge angeben, die bei einem erfolgreichen Erstellungsvorgang ausgeführt wurden.

Wert	Bedeutung
ATOMIC_CREATE_ECP_OUT_FLAG_SPARSE_SET	Gibt an, dass das Sparseflag für die Datei festgelegt wurde.
ATOMIC_CREATE_ECP_OUT_FLAG_REPARSE_POINT_SET	Gibt an, dass ein Analysepunkt für die Datei festgelegt wurde.
ATOMIC_CREATE_ECP_OUT_FLAG_EOF_SET	Gibt an, dass eine Dateigröße für die Datei festgelegt wurde und dass die Datenträgerzuordnung aufgetreten ist, um die angeforderte Dateigröße zu unterstützen.
ATOMIC_CREATE_ECP_OUT_FLAG_VDL_SET	Gibt an, dass eine gültige Datenlänge für die Datei festgelegt wurde und dass die Dateigröße auf mindestens die angeforderte gültige Datenlänge festgelegt wurde.
ATOMIC_CREATE_ECP_OUT_FLAG_OPERATION_MASK	Verwenden Sie diesen Flagwert als Maske, um die zusätzlichen Vorgänge zu bestimmen, die mit dem Erstellungsvorgang ausgeführt wurden.

ReparseBufferLength

Die Länge des ReparseBuffer-Elements . Dieser Wert darf den MAXIMUM_REPARSE_DATA_BUFFER_SIZE (16K) nicht überschreiten.

ReparseBuffer

Der optionale Wert, der den Typ des Puffers angibt, der im Erstellungsvorgang verwendet wird. Mögliche Werte sind REPARSE_DATA_BUFFER oder REPARSE_GUID_DATA_BUFFER.

FileSize

Der optionale Wert, der mit ATOMIC_CREATE_ECP_IN_FLAG_EOF_SPECIFIED verwendet wird, um die angeforderte Dateigröße anzugeben, die für die Datei festgelegt werden soll.

ValidDataLength

Der optionale Wert, der mit ATOMIC_CREATE_ECP_IN_FLAG_VDL_SPECIFIED verwendet wird, um die angeforderte gültige Datenlänge anzugeben, die für die Datei festgelegt werden soll.

FileTimestamps

Zeiger auf eine optionale FILE_TIMESTAMPS-Struktur, die die letzte aufgezeichnete instance bestimmter Aktionen für eine Datei enthält.

FileAttributes

Gibt die Attribute einer Datei an.

UsnSourceInfo

Gibt optionale USN-Quellinformationsflags (Update Sequence Number) an.

Usn

Gibt die Updatesequenznummer (USN) an. Dieser Wert wird am Ende von GUID_ECP_ATOMIC_CREATE ausgefüllt.

SuppressFileAttributeInheritanceMask

Maske, die die Dateiattribute angibt, deren normale Vererbungsregeln unterdrückt werden sollen.

InOpFlags

ATOMIC_CREATE_ECP_IN_OP_FLAG_xxx Flags.

OutOpFlags

ATOMIC_CREATE_ECP_OUT_OP_FLAG_xxx Flags.

InGenFlags

ATOMIC_CREATE_ECP_IN_GN_FLAG_xxx Flags.

OutGenFlags

ATOMIC_CREATE_ECP_OUT_GN_FLAG_xxx Flags.

CaseSensitiveFlagsMask

Gibt an, welche FILE_CS_FLAG_xxx Flags angegeben werden; Dateisysteme sollten die Standardwerte für andere Flags auswählen.

InCaseSensitiveFlags

Geben Sie die Groß-/Kleinschreibungsflags für die Datei ein. Selbst wenn kein BEST_EFFORT angegeben ist, können Dateisysteme einige der InCaseSensitiveFlags ignorieren. Das Verhalten ähnelt FileCaseSensitiveInformation, sodass Aufrufer OutCaseSensitiveFlags untersuchen können, um die festgelegten Flags zu kennen. Wenn ein Flag für eine Datei oder ein Verzeichnis nicht unterstützt wird, wird BEST_EFFORT wirksam.

OutCaseSensitiveFlags

Dieses Element gibt die Flags für die Groß-/Kleinschreibung in der Datei zurück, auch wenn keine InCaseSensitiveFlags angegeben sind.

Hinweise

Der systemdefinierte GUID_ECP_ATOMIC_CREATE**-Wert wird mit dieser ECP-Kontextstruktur verwendet, wenn ECP-bezogene Supportroutinen wie FltAllocateExtraCreateParameter und FsRtlRemoveExtraCreateParameter aufgerufen werden.

Weitere Informationen finden Sie unter Einführung in zusätzliche Erstellungsparameter .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1607
Unterstützte Mindestversion (Server)	Windows Server 2016
Kopfzeile	ntifs.h