Edit

_TRANSFER_SOURCE_FLAGS enumeration (shobjidl_core.h)

  • Article

Used by methods of the ITransferSource and ITransferDestination interfaces to control their file operations.

Syntax

typedef enum _TRANSFER_SOURCE_FLAGS {
  TSF_NORMAL = 0,
  TSF_FAIL_EXIST = 0,
  TSF_RENAME_EXIST = 0x1,
  TSF_OVERWRITE_EXIST = 0x2,
  TSF_ALLOW_DECRYPTION = 0x4,
  TSF_NO_SECURITY = 0x8,
  TSF_COPY_CREATION_TIME = 0x10,
  TSF_COPY_WRITE_TIME = 0x20,
  TSF_USE_FULL_ACCESS = 0x40,
  TSF_DELETE_RECYCLE_IF_POSSIBLE = 0x80,
  TSF_COPY_HARD_LINK = 0x100,
  TSF_COPY_LOCALIZED_NAME = 0x200,
  TSF_MOVE_AS_COPY_DELETE = 0x400,
  TSF_SUSPEND_SHELLEVENTS = 0x800
} ;

Constants

 
TSF_NORMAL
Value: 0
Fail if the destination already exists, unless TSF_OVERWRITE_EXIST is specified. This is a default behavior.
TSF_FAIL_EXIST
Value: 0
Fail if the destination already exists, unless TSF_OVERWRITE_EXIST is specified. This is a default behavior.
TSF_RENAME_EXIST
Value: 0x1
Rename with auto-name generation if the destination already exists.
TSF_OVERWRITE_EXIST
Value: 0x2
Overwrite or merge with the destination.
TSF_ALLOW_DECRYPTION
Value: 0x4
Allow creation of a decrypted destination.
TSF_NO_SECURITY
Value: 0x8
No discretionary access control list (DACL), system access control list (SACL), or owner.
TSF_COPY_CREATION_TIME
Value: 0x10
Copy the creation time as part of the copy. This can be useful for a move operation that is being used as a copy and delete operation (TSF_MOVE_AS_COPY_DELETE).
TSF_COPY_WRITE_TIME
Value: 0x20
Copy the last write time as part of the copy.
TSF_USE_FULL_ACCESS
Value: 0x40
Assign write, read, and delete permissions as share mode.
TSF_DELETE_RECYCLE_IF_POSSIBLE
Value: 0x80
Recycle on file delete, if possible.
TSF_COPY_HARD_LINK
Value: 0x100
Hard link to the desired source (not required). This avoids a normal copy operation.
TSF_COPY_LOCALIZED_NAME
Value: 0x200
Copy the localized name.
TSF_MOVE_AS_COPY_DELETE
Value: 0x400
Move as a copy and delete operation.
TSF_SUSPEND_SHELLEVENTS
Value: 0x800
Suspend Shell events.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header shobjidl_core.h (include Shobjidl.h)

See also

ITransferDestination::CreateItem

ITransferSource::LinkItem

ITransferSource::MoveItem

ITransferSource::OpenItem

ITransferSource::RecycleItem

ITransferSource::RemoveItem

ITransferSource::RenameItem