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
| 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 |