This topic has not yet been rated - Rate this topic

TRANSFER_SOURCE_FLAGS enumeration

Applies to: desktop apps only

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 
} TRANSFER_SOURCE_FLAGS;

Constants

TSF_NORMAL

Fail if the destination already exists, unless TSF_OVERWRITE_EXIST is specified. This is a default behavior.

TSF_FAIL_EXIST

Fail if the destination already exists, unless TSF_OVERWRITE_EXIST is specified. This is a default behavior.

TSF_RENAME_EXIST

Rename with auto-name generation if the destination already exists.

TSF_OVERWRITE_EXIST

Overwrite or merge with the destination.

TSF_ALLOW_DECRYPTION

Allow creation of a decrypted destination.

TSF_NO_SECURITY

No discretionary access control list (DACL), system access control list (SACL), or owner.

TSF_COPY_CREATION_TIME

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

Copy the last write time as part of the copy.

TSF_USE_FULL_ACCESS

Assign write, read, and delete permissions as share mode.

TSF_DELETE_RECYCLE_IF_POSSIBLE

Recycle on file delete, if possible.

TSF_COPY_HARD_LINK

Hard link to the desired source (not required). This avoids a normal copy operation.

TSF_COPY_LOCALIZED_NAME

Copy the localized name.

TSF_MOVE_AS_COPY_DELETE

Move as a copy and delete operation.

TSF_SUSPEND_SHELLEVENTS

Suspend Shell events.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Shobjidl.h

IDL

Shobjidl.idl

See also

ITransferDestination::CreateItem
ITransferSource::LinkItem
ITransferSource::MoveItem
ITransferSource::OpenItem
ITransferSource::RecycleItem
ITransferSource::RemoveItem
ITransferSource::RenameItem

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ