ECP_OPEN_PARAMETERS-Struktur (ntifs.h)

  • Artikel

Die ECP_OPEN_PARAMETERS-Struktur enthält den ECP-Kontext (Extra Create Parameters), mit dem ein Aufrufer den Zweck des Öffnens einer Datei angeben kann, ohne vorhandene Handles und/oder opportunistische Sperren (Oplocks) für die Datei zu beeinträchtigen.

Syntax

typedef struct _ECP_OPEN_PARAMETERS {
  USHORT Size;
  USHORT Reserved;
  ULONG  Flags;
} ECP_OPEN_PARAMETERS, *PECP_OPEN_PARAMETERS;

Member

Size

Gibt die Größe dieser Kontextstruktur in Bytes an.

Reserved

Für die zukünftige Verwendung reserviert. Dies muss mit 0 initialisiert werden.

Flags

Flags, die die Parameter oder den Zweck zum Öffnen einer Datei angeben. Flags können eine beliebige Kombination der folgenden Werte sein:

Wert BESCHREIBUNG
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ (0x0001) Öffnen der Datei, um sie zu lesen.
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE (0x0002) Öffnen der Datei zum Schreiben.
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_DELETE (0x0004) Öffnen der Datei, um sie zu löschen.
ECP_OPEN_PARAMETERS_FLAG_IGNORE_DIR_CASE_SENSITIVITY (0x0008) Erzwingt eine Suche ohne Beachtung der Groß-/Kleinschreibung für diese Datei, auch unter einem Verzeichnis, in dem die Groß-/Kleinschreibung beachtet wird. Verfügbar ab Windows 10, Version 2004.
ECP_OPEN_PARAMETERS_FLAG_FAIL_ON_CASE_SENSITIVE_DIR ( 0x0010) Schlägt das Öffnen der Datei oder die Erstellungsanforderung fehl, wenn der Pfad Verzeichnisse enthält, in dem die Groß-/Kleinschreibung beachtet wird. Verfügbar ab Windows 10, Version 2004.

Hinweise

Die ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ- und ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE-Flags ermöglichen Lese-/Schreibzugriff auf verschlüsselte Dateien, ohne diese Dateien tatsächlich für Lese-/Schreibzugriff öffnen zu müssen. Diese ECP-Flags ermöglichen es einer Kernelmoduskomponente, sich für den reinen Metadatenzugriff zu öffnen, wodurch der andere Zugriff nicht beeinträchtigt wird, während der Verschlüsselungskontext dennoch eingerichtet wird, um Lese-/Schreibvorgänge auszuführen. Ein Filter kann diese Flags festlegen, um Konflikte mit sperren zu vermeiden. Das Einrichten des Verschlüsselungszustands für Lese-/Schreibvorgänge ist teuer und wird in der Regel nicht durchgeführt, wenn Dateien nicht für Lese-/Schreibzugriff geöffnet werden.

Der systemdefinierte GUID_ECP_OPEN_PARAMETERS-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 1709.
Kopfzeile ntifs.h (include Ntifs.h)

Weitere Informationen

FltAllocateExtraCreateParameterList

FltCreateFileEx2