Rotina MRxSetFileInfo

Artigo
02/12/2024

A rotina MRxSetFileInfo é chamada pelo RDBSS para solicitar que um minidiretório de rede defina informações de arquivo em um objeto do sistema de arquivos.

Sintaxe

PMRX_CALLDOWN MRxSetFileInfo;

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

Parâmetros

RxContext [in, out]
Um ponteiro para a estrutura RX_CONTEXT. Esse parâmetro contém o IRP que está solicitando a operação.

Retornar valor

MRxSetFileInfo retorna STATUS_SUCCESS com êxito ou um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_ACCESS_DENIED	O chamador não tinha a segurança adequada para esta operação.
STATUS_INSUFFICIENT_RESOURCES	Não havia recursos suficientes para concluir a consulta.
STATUS_INVALID_PARAMETER	Um parâmetro inválido foi especificado.
STATUS_NETWORK_ACCESS_DENIED	O acesso à rede foi negado. Esse erro poderá ser retornado se o minidiretório de rede for solicitado a definir informações de arquivo em um compartilhamento somente leitura.
STATUS_NOT_IMPLEMENTED	Um recurso solicitado, como definir informações de arquivo em um arquivo de página remota, não é implementado.
STATUS_OBJECT_NAME_NOT_FOUND	O nome do objeto não foi encontrado. Esse erro poderá ser retornado se o minidiretório de rede for solicitado a definir informações de arquivo em um arquivo, mas o arquivo não existir.
STATUS_OBJECT_PATH_NOT_FOUND	O caminho do objeto não foi encontrado. Esse erro poderá ser retornado se um objeto de fluxo NTFS tiver sido passado e o sistema de arquivos remoto não oferecer suporte a fluxos.
STATUS_ONLY_IF_CONNECTED	A estrutura SRV_OPEN não está conectada.
STATUS_REPARSE	Uma nova análise é necessária para lidar com um link simbólico.

Comentários

O RDBSS emite uma chamada para MRxSetFileInfo em resposta ao recebimento de uma solicitação de IRP_MJ_SET_INFORMATION .

Antes de chamar MRxSetFileInfo, o RDBSS modifica os seguintes membros na estrutura RX_CONTEXT apontada pelo parâmetro RxContext :

O membro Info.FileInformationClass é definido como IrpSp-Parameters.SetFile.FileInformationClass>, o valor FILE_INFORMATION_CLASS especificado.

O membro Info.Buffer está definido como Irp-AssociatedIrp.SystemBuffer>.

O membro Info.Length é definido como IrpSp-Parameters.SetFile.Length>.