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
Establézcalo en TRUE para establecer la marca de FO_REMOTE_ORIGIN en el objeto de archivo, FALSE para borrarlo.
Valor devuelto
Si la marca 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 ni borra la marca.
Observaciones
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 | Valor |
|---|---|
| cliente mínimo admitido | Esta rutina está disponible en Microsoft Windows XP y versiones posteriores. |
| de la plataforma de destino de | Universal |
| encabezado de | ntddk.h (incluya Ntddk.h, Ntifs.h, Fltkernel.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | Cualquier nivel |