[ Previous | Next | Contents | Glossary | Home | Search ]
Ultimedia Services Version 2 for AIX: Programmer's Guide and Reference

Accessing Configuration Data with UMSConfig Object

The UMSConfig object provides access to the configuration data. A query of the configuration data usually begins by seeking to a specified alias name. The method string seek_alias( in string alias ) is provided for this function. The method seeks to the specified alias name or a derivative of the name and returns the actual matched alias name. If no match is found, a NULL value is returned.

After seeking to a specific alias stanza, some data within the clause is typically accessed. The method string get_property( in string property ) can be used to return the value string associated with the given property name. Alternately, the method string get_value( in string value ) can be used to return a property name associated with a given value string.

The method string get_next_property( ) can be used to access sequentially the property names within a stanza. This is useful for accessing the property name lists contained in stanzas like the audio inputs alias.

The method ReturnCode seek_next( ) is used to seek to the next clause of an alias stanza.

For introductory information, see Programming with Configuration Objects.

[ Previous | Next | Contents | Glossary | Home | Search ]