Función IoSetFileOrigin (ntddk.h)

  • Artículo

La rutina IoSetFileOrigin especifica si un objeto de archivo determinado es para una solicitud de creación remota.

Sintaxis

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

Parámetros

[in] FileObject

Puntero al objeto de archivo.

[in] Remote

Establezca en TRUE para establecer la marca FO_REMOTE_ORIGIN en el objeto de archivo, FALSE para borrarla.

Valor devuelto

Si la marca de FO_REMOTE_ORIGIN en el objeto de archivo aún no está establecida (o desactivada) según lo especificado por el parámetro Remote , IoSetFileOrigin establece o borra la marca según corresponda y devuelve STATUS_SUCCESS.

Si la marca ya está establecida (o desactivada) como se especifica, IoSetFileOrigin devuelve STATUS_INVALID_PARAMETER_MIX y no establece o borra la marca.

Comentarios

Los sistemas de archivos de red llaman a IoSetFileOrigin para establecer o borrar la marca de FO_REMOTE_ORIGIN en el objeto de archivo al que apunta FileObject. Esta marca se establece para indicar que el objeto de archivo se creó para satisfacer una solicitud de creación remota.

Los sistemas de archivos de red deben llamar a IoSetFileOrigin en sus servidores para cualquier objeto de archivo que se cree para satisfacer una solicitud de creación desde un cliente de red.

Los controladores de filtro del sistema de archivos no deben llamar a IoSetFileOrigin.

Requisitos

Requisito Value
Cliente mínimo compatible Esta rutina está disponible en Microsoft Windows XP y versiones posteriores.
Plataforma de destino Universal
Encabezado ntddk.h (incluya Ntddk.h, Ntifs.h, Fltkernel.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL Cualquier nivel

Consulte también

IoIsFileOriginRemote