ECP_OPEN_PARAMETERS-Struktur (ntifs.h)
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) |