Função IoSetFileOrigin (ntddk.h)
A rotina de 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 limpá-lo.
Valor de retorno
Se o sinalizador FO_REMOTE_ORIGIN no objeto de arquivo ainda não estiver definido (ou desmarcado), 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 desmarcado) conforme especificado, IoSetFileOrigin retornará STATUS_INVALID_PARAMETER_MIX e não definirá ou desmarcará o sinalizador.
Observações
Os sistemas de arquivos de rede chamam IoSetFileOrigin para definir ou limpar o sinalizador de 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 |
|---|---|
| de cliente com suporte mínimo | Essa rotina está disponível no Microsoft Windows XP e posterior. |
| da Plataforma de Destino | Universal |
| cabeçalho | ntddk.h (incluem Ntddk.h, Ntifs.h, Fltkernel.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | Qualquer nível |