Export (0) Print
Expand All
Expand Minimize

IoSetFileOrigin routine

The IoSetFileOrigin routine specifies whether a given file object is for a remote create request.

Syntax


NTSTATUS IoSetFileOrigin(
  _In_  PFILE_OBJECT FileObject,
  _In_  BOOLEAN Remote
);

Parameters

FileObject [in]

Pointer to the file object.

Remote [in]

Set to TRUE to set the FO_REMOTE_ORIGIN flag on the file object, FALSE to clear it.

Return value

If the FO_REMOTE_ORIGIN flag on the file object is not already set (or cleared) as specified by the Remote parameter, IoSetFileOrigin sets or clears the flag as appropriate and returns STATUS_SUCCESS.

If the flag is already set (or cleared) as specified, IoSetFileOrigin returns STATUS_INVALID_PARAMETER_MIX and does not set or clear the flag.

Remarks

Network file systems call IoSetFileOrigin to set or clear the FO_REMOTE_ORIGIN flag on the file object pointed to by FileObject. This flag is set to indicate that the file object was created to satisfy a remote create request.

Network file systems should call IoSetFileOrigin in their servers for any file objects that are created to satisfy a create request from a network client.

File system filter drivers should not call IoSetFileOrigin.

Requirements

Version

This routine is available on Microsoft Windows XP and later.

Header

Ntddk.h (include Ntddk.h, Ntifs.h, or Fltkernel.h)

Library

Ntoskrnl.lib

IRQL

Any level

See also

IoIsFileOriginRemote

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft