CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT-Struktur (ntifs.h)

  • Artikel

Die CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT-Struktur enthält den zusätzlichen ECP-Kontext (Create Parameter), der an das CSV-Dateisystem (Cluster Shared Volumes) gesendet werden kann, um Eigenschaften für die Behandlung von E/A festzulegen, die bei dieser geöffneten Datei eintreffen.

Syntax

typedef struct _CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT {
  SIZE_T Size;
  ULONG  PauseTimeoutInSeconds;
  ULONG  Flags;
} CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT, *PCSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT;

Member

Size

Größe dieser Struktur in Bytes.

PauseTimeoutInSeconds

Die Anzahl der Sekunden, die CSVFS zum Halten von E/A für dieses Dateiobjekt in einem ausstehenden Zustand zulassen darf, wenn das CSV-Volume angehalten wird. Nach Ablauf der Zeit schließt CSV alle für dieses Dateiobjekt ausgegebenen E/A mit status STATUS_CSV_IO_PAUSE_TIMEOUT ab. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
0xFFFFFFFF Gibt an, dass kein Timeout vorliegt und das Standardverhalten angefordert wird.
0 CSV hält E/A nicht an und schließt E/A sofort ab.
Ein beliebiger anderer Wert. CSV rundet alle anderen Werte auf ein Vielfaches von 10 Sekunden auf und verwendet diesen Wert als Timeout. Der maximale unterstützte Timeoutwert beträgt 30 Minuten. Wenn der angegebene Wert größer als 30 Minuten ist, legt CSV den Wert unbeaufsichtigt auf den Maximalwert fest.

Flags

Die set-Eigenschaftsflags. Dieser Member kann ein bitweiser OR der folgenden Flags sein.

Flag Bedeutung
CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR Teilt CSVFS mit, dass diese geöffnete Datei nur auf dem koordinierenden Knoten gültig sein soll. Wenn das geöffnete zu CSVFS kommt und der Knoten kein koordinierendes Knoten ist, schlägt das Öffnen fehl. Wenn die Datei geöffnet und der koordinierende Knoten verschoben wird, wird die geöffnete Datei ungültig. Dieses Flag wird nur verwendet, wenn die Datei direkt in CSVFS geöffnet wird, und wird ignoriert, wenn die Datei über SMB geöffnet wird.

Die unteren 16 Bits von Flags gelten für Flags, die dazu führen würden, dass die Erstellung mit STATUS_INVALID_PARAMETER fehlschlägt, wenn CSV sie nicht erkennt. Die oberen 16 Bits gelten für Flags, die unbeaufsichtigt ignoriert werden, wenn CSVFS nicht weiß, wie sie behandelt werden sollen.

Hinweise

Der systemdefinierte GUID_ECP_CSV_SET_HANDLE_PROPERTIES-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 8
Kopfzeile ntifs.h