FLT_PARAMETERS für IRP_MJ_SET_INFORMATION Union

Artikel
03/14/2023

Union-Komponente, die verwendet wird, wenn das Feld MajorFunction der FLT_IO_PARAMETER_BLOCK-Struktur für den Vorgang IRP_MJ_SET_INFORMATION ist.

Syntax

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    ULONG                                    Length;
    FILE_INFORMATION_CLASS POINTER_ALIGNMENT FileInformationClass;
    PFILE_OBJECT                             ParentOfTarget;
    union {
      struct {
        BOOLEAN ReplaceIfExists;
        BOOLEAN AdvanceOnly;
      };
      ULONG  ClusterCount;
      HANDLE DeleteHandle;
    };
    PVOID                                    InfoBuffer;
  } SetFileInformation;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Member

SetFileInformation: Struktur, die die folgenden Member enthält.
Länge: Länge des Puffers in InfoBuffer in Bytes.

FileInformationClass: Typ der Informationen, die für die Datei festgelegt werden sollen. Einer der folgenden:

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.
FileValidDataLengthInformation	Legen Sie FILE_VALID_DATA_LENGTH_INFORMATION für die Datei fest.

ParentOfTarget: Für Umbenennungs- oder Verknüpfungsvorgänge. Wenn InfoBuffer-FileName> einen vollqualifizierten Dateinamen enthält oder InfoBuffer-RootDirectory> nicht NULL ist, ist dieser Member ein Dateiobjektzeiger für das übergeordnete Verzeichnis der Datei, die das Ziel des Vorgangs ist. Andernfalls ist er NULL.
( unbenannte Struktur )
Struktur, die die folgenden Member enthält.
ReplaceIfExists: Für Umbenennungs- oder Verknüpfungsvorgänge. Legen Sie diesen Wert auf TRUE fest, um anzugeben, dass eine Datei, die bereits mit demselben Namen vorhanden ist, durch die angegebene Datei ersetzt werden soll. Legen Sie auf FALSE fest, wenn der Umbenennungs- oder Verknüpfungsvorgang fehlschlagen soll, wenn bereits eine Datei mit dem angegebenen Namen vorhanden ist.
AdvanceOnly: Ein Flag für Dateiendevorgänge. Dies bestimmt die Verwendung des EndOfFile-ElementsFILE_END_OF_FILE_INFORMATION Struktur bei FileInformationClass == FileEndOfFileInformation. Bei TRUE wird nur dann eine neue gültige Datenlänge für die Datei von EndOfFile festgelegt, wenn dies die aktuell gültige Datenlänge erhöht. Bei FALSE wird eine neue Dateigröße aus EndOfFile festgelegt.
ClusterCount: Für die Systemverwendung reserviert. Nicht verwenden.
DeleteHandle: Für die Systemverwendung reserviert. Nicht verwenden.
InfoBuffer: Zeiger auf einen Eingabepuffer, der die festzulegenden Dateiinformationen enthält.

Hinweise

Die FLT_PARAMETERS-Struktur für IRP_MJ_SET_INFORMATION-Vorgänge enthält die Parameter für einen Set-Information-Vorgang, der durch eine Rückrufdatenstruktur (FLT_CALLBACK_DATA) dargestellt wird. Sie ist in einer FLT_IO_PARAMETER_BLOCK-Struktur enthalten.

IRP_MJ_SET_INFORMATION ist ein IRP-basierter Vorgang.

Das AdvanceOnly-Element wird vom Cache-Manager auf TRUE festgelegt, um das Dateisystem zu benachrichtigen, die aktuell gültige Datenlänge auf dem Datenträger auf die neue gültige Datenlänge in EndOfFile zu aktualisieren. Wenn AdvanceOnlyauf FALSE festgelegt ist, wird im EndOfFile-Element eine neue Dateigröße festgelegt, die größer oder kleiner als die aktuelle Dateigröße sein kann.