ATOMIC_CREATE_ECP_CONTEXT Struktur (ntifs.h)
Die ATOMIC_CREATE_ECP_CONTEXT-Struktur enthält den zusätzlichen Create-Parameterkontext (ECP), der es zulässt, dass ergänzende Vorgänge während der Erstellung atomar für eine Datei ausgeführt werden.
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;
Angehörige
Size
Die Größe dieser Kontextstruktur in Byte.
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 Sparse-Flag 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 für die Datei eine Dateigröße festgelegt wird. Dies impliziert auch |
| diese On-Disk-Zuweisung erfolgt, um die angeforderte Dateigröße zu unterstützen. | |
| ATOMIC_CREATE_ECP_IN_FLAG_VDL_SPECIFIED | Fordert an, dass für die Datei eine gültige Datenlänge festgelegt wird. Dies bedeutet auch, dass die Dateigröße mindestens auf die angeforderte gültige Datenlänge festgelegt wird. HINWEIS: Dies wird als privilegierter Vorgang betrachtet, wenn er potenziell möglich ist. |
| nicht initialisierte Daten verfügbar machen. | |
| ATOMIC_CREATE_ECP_IN_FLAG_OPERATION_MASK | Verwenden Sie dieses Kennzeichen als Maske, um die anderen InFlags- Flagwerte anzugeben. |
| ATOMIC_CREATE_ECP_IN_FLAG_BEST_EFFORT | Gibt an, dass das Dateisystem den Erstellungsvorgang ausführen soll, auch wenn einige der angeforderten ergänzenden Vorgänge nicht vorhanden sein konnten. |
| vom Dateisystem ausgeführt oder 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 fehlschlagen, wenn er nicht alle angeforderten ergänzenden Vorgänge erfolgreich ausführen kann. |
OutFlags
Flags, die die tatsächlichen ergänzenden Vorgänge angeben, die mit einem erfolgreichen Erstellungsvorgang ausgeführt wurden.
| Wert | Bedeutung |
|---|---|
| ATOMIC_CREATE_ECP_OUT_FLAG_SPARSE_SET | Gibt an, dass das Sparse-Flag für die Datei festgelegt wurde. |
| ATOMIC_CREATE_ECP_OUT_FLAG_REPARSE_POINT_SET | Gibt an, dass für die Datei ein Analysepunkt festgelegt wurde. |
| ATOMIC_CREATE_ECP_OUT_FLAG_EOF_SET | Gibt an, dass eine Dateigröße für die Datei festgelegt wurde und dass die Zuweisung auf dem Datenträger 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 mindestens auf die angeforderte gültige Datenlänge festgelegt wurde. |
| ATOMIC_CREATE_ECP_OUT_FLAG_OPERATION_MASK | Verwenden Sie diesen Kennzeichenwert als Maske, um die zusätzlichen Vorgänge zu bestimmen, die mit dem Erstellungsvorgang ausgeführt wurden. |
ReparseBufferLength
Die Länge des ReparseBuffer Members. Dieser Wert darf den MAXIMUM_REPARSE_DATA_BUFFER_SIZE (16 KB) 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
Zeigen Sie auf eine optionale FILE_TIMESTAMPS Struktur, die die zuletzt aufgezeichnete Instanz bestimmter Aktionen für eine Datei enthält.
FileAttributes
Gibt die Attribute einer Datei an.
UsnSourceInfo
Gibt optionale USN-Quellinformationen (Update Sequence Number) an.
Usn
Gibt die Updatesequenznummer (USN) an. Dieser Wert wird am Ende 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
Kennzeichnungen bei Eingaben bei Groß-/Kleinschreibung in der Datei. Auch 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 in einer Datei oder einem 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 werden.
Bemerkungen
Der vom System definierte GUID_ECP_ATOMIC_CREATE**-Wert wird mit dieser ECP-Kontextstruktur verwendet, wenn ECP-bezogene Supportroutinen wie FltAllocateExtraCreateParameter und FsRtlRemoveExtraCreateParameteraufgerufen werden.
Weitere Informationen finden Sie unter Einführung in zusätzliche Erstellungsparameter.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1607 |
| mindestens unterstützte Server- | Windows Server 2016 |
| Header- | ntifs.h |