Protocols/MSNP/Activities/SDK/Techref/Objectmodel/Objects/Channel/Methods/SendFile
<a class="clsStd" href="/techref/objectmodel/objects/channel/index.htm">Channel</a>.SendFile Method (Restricted)
This method transfers a file to the remote application. The method takes a FileInfo object created through an ActiveX® control. The ActiveX control must provide the user an interface to browse and select a file to transfer. It is the responsibility of the developer to provide this ActiveX control. The method is labeled "restricted" because it is only available if the application has the ActiveX and SendFile permission flags. For more information, see [[Protocols/MSNP/Activities/SDK/../../../../../Sandbox|Standard vs. Advanced Applications]].
VBScript Syntax
set myChannel = external.Channel
' An ActiveX control is required to access a local file
set myFileWrapper = myActiveX.getfile(myFileName)
sub cmdSendFileButton_OnClick
On Error Goto Handler
myFileTracker = myChannel.SendFile(myFileWrapper)
' myFileTracker is now a FileInfo object
Exit Sub
:Handler
Document.Write("SendFile failed. Error Description: " & err.description)
End Sub
JavaScript Syntax
myChannel = window.external.Channel;
function cmdSendFileButton_OnClick() {
// An ActiveX control is required to access the local file
try {
var myFileWrapper = myActiveX.getfile();
myFileTracker = myChannel.SendFile(myFileWrapper);
// myFileTracker is now a FileInfo object
}
catch(ex) {
document.write("SendFile failed. Error Description: " + ex.description);
}
}
Parameters
- pdFileInfo
- A FileInfo object that contains the path to the file to be sent.
Return Values
Returns a FileInfo object that contains the properties of the file transfer.
Remarks
An exception is thrown if the application does not have both the ActiveX and SendFile permissions, or if the parameter does not correspond to a valid file object.