Função IoSetFileOrigin (ntddk.h)

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

Confira também

IoIsFileOriginRemote