MRxSetFileInfoAtCleanup-Routine

Artikel
02/02/2024

Die MRxSetFileInfoAtCleanup-Routine wird von RDBSS aufgerufen, um anzufordern, dass ein Netzwerk-Mini-Redirector Dateiinformationen für ein Dateisystemobjekt bei der Bereinigung festgelegt.

Syntax

PMRX_CALLDOWN MRxSetFileInfoAtCleanup;

NTSTATUS MRxSetFileInfoAtCleanup(
  _Inout_ PRX_CONTEXT RxContext
)
{ ... }

Parameter

RxContext [in, out]
Ein Zeiger auf die RX_CONTEXT-Struktur. Dieser Parameter enthält das IRP, das den Vorgang anfordert.

Rückgabewert

MRxSetFileInfoAtCleanup gibt STATUS_SUCCESS nach Erfolg oder einen entsprechenden NTSTATUS-Wert zurück.

Hinweise

RDBSS gibt während der Bereinigung einen Aufruf von MRxSetFileInfoAtCleanup aus, wenn das letzte Handle für ein Dateiobjekt geschlossen wird. Dies unterscheidet sich von dem Schließen-Vorgang, der aufgerufen wird, wenn der letzte Verweis auf ein Dateiobjekt gelöscht wird.

MRxSetFileInfoAtCleanup wird von RDBSS aufgerufen, wenn sich die Zeitstempel für eine Datei oder die Größe einer Datei geändert haben. Die Aufrufe von MRxSetFileInfoAtCleanup von RDBSS werden für jede dieser Änderungen separat ausgeführt. Wenn sich sowohl die Dateigröße als auch die Zeitstempel geändert haben, führt RDBSS zwei Aufrufe von MRxSetFileInfoAtCleanup durch.

Vor dem Aufrufen von MRxSetFileInfoAtCleanup ändert RDBSS die folgenden Member in der RX_CONTEXT-Struktur, auf die der RxContext-Parameter verweist, wenn sich die Zeitstempel für eine Datei geändert haben:

Das Info.FileInformationClass-Element ist auf den FILE_INFORMATION_CLASS Wert FileBasicInformation festgelegt.

Das Info.Buffer-Element wird auf eine FILE_BASIC_INFORMATION-Struktur festgelegt, die dem Stapel zugeordnet ist.

Der Info.Length-Member wird auf die Größe einer FILE_BASIC_INFORMATION-Struktur festgelegt.

Vor dem Aufrufen von MRxSetFileInfoAtCleanup ändert RDBSS die folgenden Member in der RX_CONTEXT-Struktur, auf die der RxContext-Parameter verweist, wenn sich die Größe einer Datei geändert hat:

Das Info.FileInformationClass-Element ist auf den FILE_INFORMATION_CLASS Wert FileEndOfFileInformation festgelegt.

Das Info.Buffer-Element wird auf eine FILE_END_OF_FILE_INFORMATION-Struktur festgelegt, die dem Stapel zugeordnet ist.

Das Info.Length-Element ist auf sizeof(FILE_END_OF_FILE_INFORMATION) festgelegt.

RDBSS ignoriert den Rückgabewert von MRxSetFileInfoAtCleanup.

Ein Netzwerk-Mini-Redirector kann in dieser Routine nichts tun und STATUS_SUCCESS zurückgeben. Alle Änderungen an der Dateigröße oder zeitstempel werden während des Bereinigungsvorgangs behandelt.