ren_warn_t

Contains information about an FSHOOK_TYPE_RENAME_WARN event.

Service:
Defined In:fshooks.h

Structure

  typedef struct
  {
     uint32_t     enterExitID;
     uint32_t     slotID;
     uint32_t     taskID;
     zid_t        zid;
     volid_t      volID;
     zid_t        destZid;
     unicode_t   *destName;
     uint32_t     renameFlags;
  } ren_warn_t;
  

Fields

enterExitID

Associates the warn and report events of the operation and is same value on the warn and report events of the same operation, but unique across operations.

slotID

Contains the connection number of the entity that caused the event.

taskID

Contains the task number associated with the event. This is usually set to 50, the NSS taskID.

zid

Contains the zid that identifies the file object to renamed. A zid uniquely identifies a file object within a given volume.

volID

Contains the ID of the volume associated with the zid.

destZid

Contains the target zid for the renamed file object.

destName

Points to the target path and name of the file object to be renamed. This path must resolve to a directory that exists, and it must also contain a leaf name which does not yet exist.The target directory must reside in the same volume as the source directory. The character set for the path name is Unicode.

renameFlags

Contains a bit mask that identifies various actions to take when renaming the file.

Flag

Value

Description

FSHOOKS_RENAME_ALLOW_RENAMES_TO_MYSELF

0x00000001

Allows a file to be named to its same place without returning an error.

FSHOOKS_RENAME_THIS_ NAME_SPACE_ONLY

0x00000004

Specifies the source and destination name spaces must be the same.

Remarks

You can use the fs_getslotinfo function to obtain more information about who caused the event and the fs_mapzidtopath function to obtain the name of the file that is being renamed.