ipsend.TriggerFTS

[This is preliminary documentation and subject to change.]

The TriggerFTS method formats and transmits a data trigger that sets up FTS data reception on broadcast clients.

Syntax

object.TriggerFTS( sIPAddress, iPort, sSubDir, lTimeout)

Parts

object: Object expression that resolves to an ipsend object.
sIPAddress: String that specifies the IP address on which the FTS will be transmitted. If this parameter is NULL or an empty string (""), TriggerFTS uses the values specified during the call to ipsend.ConnectFTS.
iPort: Integer that specifies the IP port.
sSubDir: String that specifies the directory name in which the transmitted files should be saved. Note that this value cannot contain subdirectories. For example, "MSNBC" is a valid value for sSubDir, but "MSNBC\InterNight" is not.
To store a transmitted file in a subdirectory of sSubDir, specify the subdirectory when the file is transmitted.
lTimeout: Long that specifies a timeout interval, in minutes. After lTimeout minutes have elapsed, the subdirectory is deleted. If this value is zero, TriggerFTS uses the default value of 120 minutes.

Remarks

TriggerFTS differs from the SendTrigger method in that it formats the trigger string based on the parameters you pass in. SendTrigger requires a pre-formatted trigger string.

QuickInfo

  Windows NT: Unsupported.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in ipenhsnd.idl.
  Import Library: Included as a resource in ipenhsnd.dll.
  Unicode: Yes.

Examples

The following initializes broadcast clients to receive FTS data on IP address 255.255.255.255, port 980. The client will store files received over that IP address and port in "C:\Program Files\TV Viewer\Interactive Content\<random>\MSNBC\", where <random> is a random string generated by the broadcast client.