NETWORK_OPEN_ECP_CONTEXT_V0-Struktur (ntifs.h)
Die NETWORK_OPEN_ECP_CONTEXT_V0-Struktur wird verwendet, um ECP-Kontexte (Network Extra Create Parameter) für Dateien zu interpretieren.
Syntax
typedef struct _NETWORK_OPEN_ECP_CONTEXT_V0 {
USHORT Size;
USHORT Reserved;
struct {
struct {
NETWORK_OPEN_LOCATION_QUALIFIER Location;
NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
} in;
struct {
NETWORK_OPEN_LOCATION_QUALIFIER Location;
NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
} out;
} DUMMYSTRUCTNAME;
} NETWORK_OPEN_ECP_CONTEXT_V0, *PNETWORK_OPEN_ECP_CONTEXT_V0;
Member
Size
Die Größe (in Bytes) dieser Struktur.
Reserved
Reserviert. Muss auf 0 (null) festgelegt werden.
DUMMYSTRUCTNAME
Eine Struktur, die Einschränkungen für das Öffnen der Datei (vorab erstellen) und die Anwendung auf die Datei nach dem Öffnen (nach dem Erstellen) enthält.
DUMMYSTRUCTNAME.in
Struktur, die Voraberstellungseinschränkungen für das Öffnen einer Datei enthält.
DUMMYSTRUCTNAME.in.Location
Ein NETWORK_OPEN_LOCATION_QUALIFIER Typwert, der die Speicherorteinschränkung angibt, die an die Datei angefügt werden soll.
DUMMYSTRUCTNAME.in.Integrity
Ein NETWORK_OPEN_INTEGRITY_QUALIFIER typisierter Wert, der die Integritätseinschränkung angibt, die an die Datei angefügt werden soll.
DUMMYSTRUCTNAME.out
Struktur, die Einschränkungen nach der Erstellung enthält, die nach dem Öffnen auf eine Datei angewendet werden sollen.
DUMMYSTRUCTNAME.out.Location
Ein NETWORK_OPEN_LOCATION_QUALIFIER Typwert, der die Speicherorteinschränkung angibt, die an die Datei angefügt werden soll.
DUMMYSTRUCTNAME.out.Integrity
Dieser Member ist derzeit nicht implementiert und sollte ignoriert werden.
Ein NETWORK_OPEN_INTEGRITY_QUALIFIER typisierter Wert, der die Integritätseinschränkung angibt, die an die Datei angefügt werden soll.
Hinweise
Informationen zur Verwendung von ECPs zum Zuordnen zusätzlicher Informationen zu einer Datei beim Erstellen der Datei finden Sie unter Verwenden zusätzlicher Erstellungsparameter mit einem IRP_MJ_CREATE Vorgang.
Ein Filtertreiber sollte die NETWORK_OPEN_ECP_CONTEXT-Struktur als schreibgeschützt betrachten und nur zum Abrufen von Informationen zum Netzwerk-ECP-Kontext in einer Datei verwenden. Weitere Informationen finden Sie unter Systemdefinierte ECPs.
Wenn ein Aufrufer überprüfen muss, ob das Dateisystem die NETWORK_OPEN_ECP_CONTEXT_V0 Kontextstruktur bestätigt hat, sollte der Aufrufer nach Abschluss des Vorgangs die Routine FltIsEcpAcknowledged oder FsRtlIsEcpAcknowledged für den ECP aufrufen.
In den meisten Fällen verwenden Treiber, die unter Windows Vista und höheren Versionen von Windows ausgeführt werden, die NETWORK_OPEN_ECP_CONTEXT-Struktur , um Netzwerk-ECP-Kontexte für Dateien zu interpretieren. Treiber, die unter Windows 7 und höheren Versionen von Windows ausgeführt werden und Netzwerk-ECP-Kontexte für Dateien interpretieren müssen, die sich unter Windows Vista befinden, müssen stattdessen die NETWORK_OPEN_ECP_CONTEXT_V0-Struktur verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Diese Struktur ist ab Windows 7 verfügbar. |
| Kopfzeile | ntifs.h (include Ntifs.h) |