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 |