 |
|
|
|
||||
|
|||||
FTPConnection
|
||
The FTPConnection OMX component allows you to create a connection to an FTP server. Once that connection is made, you can send data to and retrieve data from the FTP server.
The OmniMark FTP dynamic link library file ("omftp.dll" or "omftp.so") creates the FTPConnection OMX component. The related include file ("omftp.xin") defines the interface to that component. To use FTPConnection OMX components in your program, you must include the following declaration and include statement in your program:
include "omftp.xin"
Within your program, you can create as many instances of the FTPConnection OMX component as you require by declaring global and local variables of type "FTPConnection". For example:
include "omftp.xin"
global FTPConnection my-ftp-1
global FTPConnection my-ftp-2
process
local FTPConnection my-ftp-3
local FTPConnection my-ftp-4
Once you have declared your FTPConnection OMX variables, you can use them in the FTPConnectionOpen function from the OmniMark FTP library to create connections to FTP servers. For example:
include "omftp.xin"
process
local FTPConnection my-ftp-connection
set my-ftp-connection to FTPConnectionOpen server "banzai.com"
user "buckaroo"
password "watermelon"
Assuming that no errors occur when establishing the connection to the FTP server, you can now send data to and receive data through the connection by using the other functions in the OmniMark FTP library.
The FTPConnection OMX component is not copyable. This means that when you set the value of one FTPConnection OMX variable to the value of another FTPConnection OMX variable, you end up with two variables pointing at the same external object. You are able to manipulate both variables, but you are performing those manipulations on the same FTP connection, whether you use the original FTPConnection OMX variable or its copy.
