Working with the ltmsServer Object

Each ltmsServer object functions as a complete server. An application can create one or more server objects.

An ltmsServer object contains the following sub-objects:

• ltmsApplicationProperties

• ltmsIPFilters

• ltmsMIMETypes

• ltmsNetworkProperties

• ltmsLiveStreams Object

• ltmsLiveStreamControls Object

Before using the ltmsServer Object, you need to set a runtime license using the ltmsLicenseManager Object object. See Setting a Runtime License for more details.

Every attribute that affects ltmsServer object operation is contained within one of the sub-objects. When an ltmsServer object is created, all attributes are initialized to their default ("factory") values. If you want a newly-created ltmsServer object to have any attributes other than the "factory" defaults, you need to import the settings from a configuration file, or set them individually.

All attribute values are stored in memory and are lost when the ltmsServer object is released, unless they have been saved by calling an export function before the object is released.

If you change any value of a sub-object's attributes, or call its "Reset" function (for example, IltmsNetworkProperties::Reset), it changes the parent ltmsServer object's sub-object properties. If you call IltmsServer::ResetConfig every sub-object's attributes are changed back to "factory" defaults.

Get a copy of any of the sub-objects by calling its "Get" function (for example, IltmsServer::GetNetworkProperties). Any changes made to a sub-object does not affect the ltmsServer object until its "Set" function is called (for example, IltmsServer::SetNetworkProperties).

If you call one of the ltmsServer object's import or export functions (IltmsServer::ExportConfigFile, IltmsServer::ExportConfigString, IltmsServer::ImportConfigFile, IltmsServer::ImportConfigString), the values of all of the sub-objects' attributes are imported from or exported to an XML configuration file.

To retrieve a copy of the server's live stream collection, call IltmsServer::GetLiveStreams. To set the live stream collection, call IltmsServer::SetLiveStreams

To retrieve the number of live stream controls, call IltmsLiveStreamControls::get_Count. To retreive the live stream control with the specified index, call IltmsLiveStreamControls::Item. To retrieve the index of the stream control that matches the specified handle, call IltmsLiveStreamControls::Find.