ECP_OPEN_PARAMETERS Struktur (ntifs.h)
Die ECP_OPEN_PARAMETERS-Struktur enthält den zusätzlichen CREATE-Parameterkontext (ECP), 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;
Angehörige
Size
Gibt die Größe dieser Kontextstruktur in Bytes an.
Reserved
Reserviert für die zukünftige Verwendung. Dies muss auf 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 zum Lesen. |
| ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE (0x0002) | Öffnen der Datei zum Schreiben in die Datei. |
| ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_DELETE (0x0004) | Datei wird geöffnet, um sie zu löschen. |
| ECP_OPEN_PARAMETERS_FLAG_IGNORE_DIR_CASE_SENSITIVITY (0x0008) | Erzwingt die Groß-/Kleinschreibung bei der Suche nach dieser Datei, auch unter einem Verzeichnis mit Groß-/Kleinschreibung. Verfügbar ab Windows 10, Version 2004. |
| ECP_OPEN_PARAMETERS_FLAG_FAIL_ON_CASE_SENSITIVE_DIR ( 0x0010) | Schlägt die Datei beim Öffnen oder Erstellen einer Anforderung fehl, wenn der Pfad über Verzeichnisse mit Groß-/Kleinschreibung verfügt. Verfügbar ab Windows 10, Version 2004. |
Bemerkungen
Die ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ- und ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE kennzeichnungen ermöglichen den Lese-/Schreibzugriff auf verschlüsselte Dateien, ohne solche Dateien tatsächlich für Lese-/Schreibzugriff öffnen zu müssen. Diese ECP-Flags ermöglichen es einer Kernelmoduskomponente, nur für den Nur-Metadaten-Zugriff zu öffnen, wodurch der Zugriff nicht beeinträchtigt wird, während die Einrichtung des Verschlüsselungskontexts weiterhin erfolgt, um Lese-/Schreibvorgänge zu erledigen. Ein Filter kann diese Flags festlegen, um Konflikte mit der Sperrung zu vermeiden. Das Einrichten des Verschlüsselungszustands für Lese-/Schreibvorgänge ist teuer und wird in der Regel nicht ausgeführt, wenn Dateien nicht für lese-/schreibzugriff geöffnet werden.
Der vom System definierte GUID_ECP_OPEN_PARAMETERS-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 1709. |
| Header- | ntifs.h (einschließlich Ntifs.h) |