Подпрограмма MRxSetFileInfoAtCleanup

Статья
02/02/2024

Подпрограмма MRxSetFileInfoAtCleanup вызывается RDBSS , чтобы запросить, чтобы сетевой мини-перенаправитель задал сведения о файлах в объекте файловой системы при очистке.

Синтаксис

PMRX_CALLDOWN MRxSetFileInfoAtCleanup;

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

Параметры

RxContext [in, out]
Указатель на структуру RX_CONTEXT. Этот параметр содержит IRP, запрашивающий операцию.

Возвращаемое значение

MRxSetFileInfoAtCleanup возвращает STATUS_SUCCESS при успешном выполнении или соответствующее значение NTSTATUS.

RDBSS выполняет вызов MRxSetFileInfoAtCleanup во время очистки при закрытии последнего дескриптора объекта файла. Это отличается от операции закрытия, которая вызывается при удалении последней ссылки на файловый объект.

MRxSetFileInfoAtCleanup вызывается RDBSS, если изменились метки времени в файле или его размер. Вызовы MRxSetFileInfoAtCleanup от RDBSS выполняются отдельно для каждого из этих изменений. Если размер файла и метки времени изменились, RDBSS выполняет два вызова MRxSetFileInfoAtCleanup.

Перед вызовом MRxSetFileInfoAtCleanup RDBSS изменяет следующие элементы в структуре RX_CONTEXT, на которую указывает параметр RxContext , если метки времени в файле изменились:

Члену Info.FileInformationClass присваивается FILE_INFORMATION_CLASS значение FileBasicInformation.

Член Info.Buffer имеет FILE_BASIC_INFORMATION структуру, выделенную в стеке.

Член Info.Length имеет размер FILE_BASIC_INFORMATION структуры.

Перед вызовом MRxSetFileInfoAtCleanup RDBSS изменяет следующие элементы в структуре RX_CONTEXT, на которую указывает параметр RxContext , если размер файла изменился:

Члену Info.FileInformationClass присваивается FILE_INFORMATION_CLASS значение FileEndOfFileInformation.

Для элемента Info.Buffer задана FILE_END_OF_FILE_INFORMATION структура, выделенная в стеке.

Для элемента Info.Length задано значение sizeof(FILE_END_OF_FILE_INFORMATION).

RDBSS игнорирует возвращаемое значение из MRxSetFileInfoAtCleanup.

Сетевой мини-перенаправление может ничего не делать в этой процедуре и возвращать STATUS_SUCCESS. Любые изменения размера файла или меток времени будут обрабатываться во время операции очистки.