FSCTL_SET_INTEGRITY_INFORMATION_BUFFER-Struktur (winioctl.h)

Artikel
08/27/2023

Eingabepuffer, der mit dem Steuerungscode FSCTL_SET_INTEGRITY_INFORMATION übergeben wird.

Syntax

typedef struct _FSCTL_SET_INTEGRITY_INFORMATION_BUFFER {
  WORD  ChecksumAlgorithm;
  WORD  Reserved;
  DWORD Flags;
} FSCTL_SET_INTEGRITY_INFORMATION_BUFFER, *PFSCTL_SET_INTEGRITY_INFORMATION_BUFFER;

Member

ChecksumAlgorithm

Gibt den Prüfsummenalgorithmus an.

Wert	Bedeutung
CHECKSUM_TYPE_NONE 0x0000	Die Datei oder das Verzeichnis ist nicht für die Verwendung der Integrität konfiguriert.
CHECKSUM_TYPE_CRC64 0x0002	Die Datei oder das Verzeichnis verwendet eine CRC64-Prüfsumme, um Integrität bereitzustellen.
3–0xfffe	Für die zukünftige Verwendung reserviert. Darf nicht verwendet werden.
CHECKSUM_TYPE_UNCHANGED 0xffff	Der Prüfsummenalgorithmus soll gleich bleiben.

Reserved

Muss 0 sein.

Flags

Enthält null oder mehr Flags.

Wert	Bedeutung
FSCTL_INTEGRITY_FLAG_CHECKSUM_ENFORCEMENT_OFF 0x00000001	Wenn dieser Wert festgelegt ist, wird die Prüfsummenerzwingung deaktiviert, und Lesevorgänge werden auch dann erfolgreich ausgeführt, wenn die Prüfsummen nicht übereinstimmen. Dieses Flag ist nur gültig, wenn für die Datei ein Integritätsalgorithmus festgelegt ist. Wenn kein Algorithmussatz vorhanden ist oder das CheckSum-Element auf CHECKSUM_TYPE_NONE festgelegt ist, schlägt der Vorgang mit ERROR_INVALID_PARAMETER fehl.

Wert

Bedeutung

FSCTL_INTEGRITY_FLAG_CHECKSUM_ENFORCEMENT_OFF
0x00000001

Wenn dieser Wert festgelegt ist, wird die Prüfsummenerzwingung deaktiviert, und Lesevorgänge werden auch dann erfolgreich ausgeführt, wenn die Prüfsummen nicht übereinstimmen. Dieses Flag ist nur gültig, wenn für die Datei ein Integritätsalgorithmus festgelegt ist. Wenn kein Algorithmussatz vorhanden ist oder das CheckSum-Element auf CHECKSUM_TYPE_NONE festgelegt ist, schlägt der Vorgang mit ERROR_INVALID_PARAMETER fehl.

Hinweise

Wenn FSCTL_INTEGRITY_FLAG_CHECKSUM_ENFORCEMENT_OFF angegeben ist und die Datei mit Freigabeberechtigungen geöffnet wird, sodass nachfolgende Öffnungen erfolgreich ausgeführt werden können, können beschädigte Daten von einer Anwendung gelesen werden, die nicht FSCTL_INTEGRITY_FLAG_CHECKSUM_ENFORCEMENT_OFF angegeben hat.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Kopfzeile	winioctl.h (windows.h einschließen)

Weitere Informationen

FSCTL_GET_INTEGRITY_INFORMATION_BUFFER

FSCTL_SET_INTEGRITY_INFORMATION

Volumeverwaltungsstrukturen

Freigeben über