Función IoSetFileOrigin (ntddk.h)
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 |