Routine MRxSetFileInfo

Articolo
06/15/2023

La routine MRxSetFileInfo viene chiamata da RDBSS per richiedere che un mini-redirector di rete imposti le informazioni sui file in un oggetto file system.

Sintassi

PMRX_CALLDOWN MRxSetFileInfo;

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

Parametri

RxContext [in, out]
Puntatore alla struttura RX_CONTEXT. Questo parametro contiene l'IRP che richiede l'operazione.

Valore restituito

MRxSetFileInfo restituisce STATUS_SUCCESS in caso di esito positivo o di un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_ACCESS_DENIED	Il chiamante non ha la sicurezza appropriata per questa operazione.
STATUS_INSUFFICIENT_RESOURCES	Risorse insufficienti per completare la query.
STATUS_INVALID_PARAMETER	È stato specificato un parametro non valido.
STATUS_NETWORK_ACCESS_DENIED	Accesso alla rete negato. Questo errore può essere restituito se è stato richiesto al mini-redirector di rete di impostare le informazioni sui file in una condivisione di sola lettura.
STATUS_NOT_IMPLEMENTED	Una funzionalità richiesta, ad esempio l'impostazione delle informazioni sui file in un file di pagina remota, non viene implementata.
STATUS_OBJECT_NAME_NOT_FOUND	Il nome dell'oggetto non è stato trovato. Questo errore può essere restituito se è stato richiesto al mini-redirector di rete di impostare le informazioni sul file in un file, ma il file non esiste.
STATUS_OBJECT_PATH_NOT_FOUND	Il percorso dell'oggetto non è stato trovato. Questo errore può essere restituito se è stato passato un oggetto flusso NTFS e il file system remoto non supporta i flussi.
STATUS_ONLY_IF_CONNECTED	La struttura SRV_OPEN non è connessa.
STATUS_REPARSE	Per gestire un collegamento simbolico è necessario un reparse.

Commenti

RDBSS invia una chiamata a MRxSetFileInfo in risposta alla ricezione di una richiesta di IRP_MJ_SET_INFORMATION .

Prima di chiamare MRxSetFileInfo, RDBSS modifica i membri seguenti nella struttura RX_CONTEXT a cui punta il parametro RxContext :

Il membro Info.FileInformationClass è impostato su IrpSp-Parameters.SetFile.FileInformationClass>, il valore FILE_INFORMATION_CLASS specificato.

Il membro Info.Buffer è impostato su Irp-AssociatedIrp.SystemBuffer>.

Il membro Info.Length è impostato su IrpSp-Parameters.SetFile.Length>.