Platform SDK: Web Telephony Engine |
Most WTE objects have methods you can use to save their settings to persistent storage or to refresh their settings from values in persistent storage. In this release, the storage method is determined at setup; it is the Active Directory™, if enabled on the server, the registry otherwise. The WTE application does not specify the type of storage when using a save operation; this is handled transparently by the run time.
The Save method stores all settings of that object (and its subordinate objects) into persistent storage. Because the Save method writes all changes for an object as well as its subordinate objects, you can save all changes to all objects by saving the top-level object. However, it is more efficient to call Save on the relevant subobject when possible.
It is important to understand that no changes are saved unless the Save method is called. If you change the value of a property, for instance, you must explicitly save the changes to the object, or the change will not be written to persistent storage.
If Active Directory is enabled on the host computer, it is the repository for persistent storage. When Active Directory is not enabled, persistent storage is in the Registry. The underlying run time handles this transparently; scripts that use the Save method do not have to specify the location for storage.
Note Some objects do not have a Save method. To save these objects, invoke the Save method of a parent of the object in the hierarchy.
The Refresh method reads the last saved values from persistent storage and applies them to the object and its subordinate objects.
The Refresh method retrieves the last-saved settings from persistent storage, and applies them to the object and to any subordinate objects. Use the Refresh method to be sure you have the current values for an object and its subordinate objects. This is useful when the object has been modified elsewhere and you need to retrieve the updated information. You can also use the Refresh method to abandon changes you've made to an object that have not yet been saved.