FltSetInformationFile-Funktion (fltkernel.h)

Artikel
02/06/2025

FltSetInformationFile Informationen für eine bestimmte Datei festlegt.

Syntax

NTSTATUS FLTAPI FltSetInformationFile(
  [in] PFLT_INSTANCE          Instance,
  [in] PFILE_OBJECT           FileObject,
  [in] PVOID                  FileInformation,
  [in] ULONG                  Length,
  [in] FILE_INFORMATION_CLASS FileInformationClass
);

Parameter

[in] Instance

Undurchsichtiger Instanzzeiger für den Aufrufer. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[in] FileObject

Dateiobjektzeiger für die Datei. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[in] FileInformation

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, der Informationen enthält, die für die Datei festgelegt werden sollen. Der parameter FileInformationClass gibt den Informationstyp an. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[in] Length

Größe des FileInformation- Puffers in Byte.

[in] FileInformationClass

Gibt den Typ der Informationen an, die für die Datei festgelegt werden sollen. Die folgenden Werte sind definiert.

Wert	Bedeutung
FileAllocationInformation-	Legen Sie FILE_ALLOCATION_INFORMATION für die Datei fest.
FileBasicInformation	Legen Sie FILE_BASIC_INFORMATION für die Datei fest.
FileDispositionInformation-	Legen Sie FILE_DISPOSITION_INFORMATION für die Datei fest.
FileEndOfFileInformation	Legen Sie FILE_END_OF_FILE_INFORMATION für die Datei fest.
FileLinkInformation-	Legen Sie FILE_LINK_INFORMATION für die Datei fest.
FilePositionInformation-	Legen Sie FILE_POSITION_INFORMATION für die Datei fest.
FileRenameInformation-	Legen Sie FILE_RENAME_INFORMATION für die Datei fest. Weitere Informationen zum Umbenennen von Dateien finden Sie im folgenden Abschnitt "Hinweise".
FileValidDataLengthInformation	Legen Sie FILE_VALID_DATA_LENGTH_INFORMATION für die Datei fest.

Rückgabewert

FltSetInformationFile- gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert zurück.

Bemerkungen

Ein Minifiltertreiber ruft FltSetInformationFile- auf, um Informationen für eine bestimmte Datei festzulegen. Die Datei muss zurzeit geöffnet sein.

Ein Dateiumbenennungsvorgang legt die folgende Einschränkung für die Parameterwerte fest, die an FltSetInformationFileübergeben werden: Wie im Referenzeintrag für FILE_RENAME_INFORMATIONangegeben, kann eine Datei oder ein Verzeichnis nur innerhalb eines Volumes umbenannt werden. Mit anderen Worten, ein Umbenennungsvorgang kann nicht dazu führen, dass eine Datei oder ein Verzeichnis auf ein anderes Volume verschoben wird. Im Gegensatz zu ZwSetInformationFile-überprüft FltSetInformationFile den Inhalt der FILE_RENAME_INFORMATION Struktur nicht. Daher ist der Aufrufer von FltSetInformationFile dafür verantwortlich, sicherzustellen, dass sich der neue Name für die Datei oder das Verzeichnis auf demselben Volume wie der alte Name befindet.

Minifiltertreiber müssen FltSetInformationFile verwenden, nicht ZwSetInformationFile-, um eine Datei umzubenennen.