Mapping Integer Property Values to Strings

Many of the properties defined in CIM contain integer values that represent status or configuration information. The qualifiers for those properties define a mapping to human-readable string values.

This example shows a general-purpose routine for converting an integer value to the corresponding string value. The example assumes that the client library you are using has support for introspecting class property information available in the qualifiers.

The following function expects three parameters:

■	A connection object that you have previously created, as described in Making a Connection to the CIMOM

■	An instance of the class that you have retrieved from the CIMOM

■	A string value containing the name of a property of that instance, to be mapped to its string descriptor

use wbemlib

use connection

 

function map_instance_property_to_string( connection, instance, prop )

   class_info = connection.GetClass( instance.classname, includeQualifiers=True )

   qualifiers = class_info.properties[ prop ].qualifiers

   if qualifiers.key( ‘ValueMap’ ) and qualifiers.key( ‘Values’ )

      strings = qualifiers[ ‘Values’ ]

      nums = qualifiers[ ‘ValueMap’ ]

      prop_val = instance[ prop ]

      for ( i=0; len( nums ) - 1; i++ )

         if str( nums[ i ] ) == str( prop_val )

            return strings[ i ]

   return Null