Função IoSetFileOrigin (ntddk.h)

  • Artigo

A rotina IoSetFileOrigin especifica se um determinado objeto de arquivo é para uma solicitação de criação remota.

Sintaxe

NTSTATUS IoSetFileOrigin(
  [in] PFILE_OBJECT FileObject,
  [in] BOOLEAN      Remote
);

Parâmetros

[in] FileObject

Ponteiro para o objeto de arquivo.

[in] Remote

Defina como TRUE para definir o sinalizador FO_REMOTE_ORIGIN no objeto de arquivo, FALSE para desmarcá-lo.

Retornar valor

Se o sinalizador FO_REMOTE_ORIGIN no objeto de arquivo ainda não estiver definido (ou limpo) conforme especificado pelo parâmetro Remote , IoSetFileOrigin definirá ou limpará o sinalizador conforme apropriado e retornará STATUS_SUCCESS.

Se o sinalizador já estiver definido (ou limpo) conforme especificado, IoSetFileOrigin retornará STATUS_INVALID_PARAMETER_MIX e não definirá ou limpará o sinalizador.

Comentários

Os sistemas de arquivos de rede chamam IoSetFileOrigin para definir ou limpar o sinalizador FO_REMOTE_ORIGIN no objeto de arquivo apontado por FileObject. Esse sinalizador é definido para indicar que o objeto de arquivo foi criado para atender a uma solicitação de criação remota.

Os sistemas de arquivos de rede devem chamar IoSetFileOrigin em seus servidores para quaisquer objetos de arquivo criados para atender a uma solicitação de criação de um cliente de rede.

Os drivers de filtro do sistema de arquivos não devem chamar IoSetFileOrigin.

Requisitos

Requisito Valor
Cliente mínimo com suporte Essa rotina está disponível no Microsoft Windows XP e posterior.
Plataforma de Destino Universal
Cabeçalho ntddk.h (inclua Ntddk.h, Ntifs.h, Fltkernel.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Qualquer nível

Confira também

IoIsFileOriginRemote