PyITransferDestination.md

PyITransferDestination

PyITransferDestination Object

Implemented by shell extensions that act as targets for item copy or move operations

Methods

• Advise

  Connects an advise sink 

• Unadvise

  Disconnects an advise sink 

• CreateItem

  Requests that a new item be created 

PyITransferDestination.Advise

int = Advise(Sink) Connects an advise sink

Parameters

• Sink : PyITransferAdviseSink

  Event sink to receive notifications

Return Value

Returns an id for the connection, to be passed to PyITransferDestination::Unadvise

PyITransferDestination.CreateItem

(int, interface, interface) = CreateItem(Name, Attributes

, Size

, Flags

, riidItem

, riidResources

) Requests that a new item be created

Parameters

• Name : str

  Filename to be created

• Attributes : int

  File attributes

• Size : int

  Size of file

• Flags : int

  Combination of shellcon.TSF_* flags

• riidItem=IID_IShellItem : PyIID

  Item interface to return

• riidResources=IID_IShellItemResources : PyIID

  Resource interface to return

Return Value

Returns the HRESULT and requested interfaces. Interfaces may be None if

function returns one of the informational codes (shellcon.COPYENGINE_S_*)

PyITransferDestination.Unadvise

Unadvise(Cookie) Disconnects an advise sink

Parameters

• Cookie : int

  Connection identifier as returned by PyITransferDestination::Advise