Protocols/MSNP/Activities/SDK/Techref/Flags/SendFile
Permission Flags - SendFile
If an application has the SendFile flag enabled in the MSN® Messenger Activity directory, then additional methods, events, and one property are available to the Channel object. The methods are SendFile and CancelSendFile. The events are OnFileReceived and OnSendFileCancelled. The property is FileInfo. Using these features, an application can transfer files to the remote computer. Only send operations are allowed; an application cannot request files from a remote computer.
Using the SendFile method and an ActiveX® control that is able to read the contents of a file on the local computer, an application can send a file to the remote computer.
Using the CancelSendFile method, a file transfer can be canceled. A file transfer in progress can be canceled by either the local application or the remote application. If a file is queued for transfer, it can be canceled by the local application.
The OnFileReceived event is fired when a file has been received from the remote application. An ActiveX control is required to save the file, since this action interacts with the local file system. Consequently, the ActiveX permission flag must also be enabled to host this control.
The OnSendFileCancelled event is fired when a file transfer is canceled, either because the local application or the remote application called the SendFileCancel method or because of an error.
The FileInfo property returns a FileInfo object. The FileInfo object contains a list of properties that describe a file transfer, including the file path and size.
An application must be able to demonstrate a need for the ability to send files to the remote application to be considered for this permission flag.
This permission flag might be useful for an application that allows users to share pictures or other files.