Share via

SMS_PropertyDisplayNode

  • Article

The SMS_PropertyDisplayNode WMI class defines the nodes that are displayed in the SMS Resource Explorer.

The following syntax is simplified from MOF code and includes all inherited properties.

Class SMS_PropertyDisplayNode : SMS_BaseClass
{
  string ClassDisplayName;
  string ClassName;
  uint32 Flags;
  uint32 NodeKey;
  string NodeName;
  uint32 PaneOrder;
  uint32 ParentNodeKey;
  string ResourceDisplayName;
  string ResultProperties[];
  string ResultPropertyIDName;
  string ScopePropertyIDName;
  string ScopePropertyNames[];
};

Properties

  • ClassDisplayName
    Data type: string

    Not used.

  • ClassName
    Data type: string
    Access type: Read/write

    Name of the inventory group class, such as SMS_G_System_CDROM, that is displayed in the scope and result pane. This property is required for leaf nodes.

  • Flags
    Data type: uint32
    Access type: Read/write
    Qualifiers: Bits

    Bit field flags that control the behavior of the node.

    Bit Description
    0 Creates a static node. Static nodes do not contain data.
    1 Creates a root node that exists at the same level as the Hardware node in the Resource Explorer.
    2 Creates a leaf node. Leaf nodes exist as children of user-defined, static root nodes or as stand-alone leaf nodes at the top level in the Resource Explorer.
    3 Not used.
    6 Creates a user-defined node. This bit is set for you by the provider — do not set this bit.

    Currently, you must use bits 0 and 1 together (this creates a static root node); you cannot use them separately. Also, only one static root node can exist.

  • NodeKey
    Data type: uint32
    Access type: Read/write
    Qualifiers: Key

    The NodeKey value is auto-generated if you do not specify a value (this is the preferred behavior). However, if you do specify a value, the NodeKey value must be unique and greater than 1000. Values of 1000 and below are reserved for SMS.

  • NodeName
    Data type: string
    Access type: Read/write

    Name of the node as displayed in the Resource Explorer. This is the literal name of the node, unless a parent node exists and it declares a value for ScopePropertyNames.

  • PaneOrder
    Data type: uint32

    Not used.

  • ParentNodeKey
    Data type: uint32
    Access type: Read/write

    Value of the NodeKey property of the parent node. This property defines the parent-child relationship. Specify a value of zero (0) to create your node at the top level.

  • ResourceDisplayName
    Data type: string

    Not used.

  • ResultProperties
    Data type: string[]
    Access type: Read/write

    List of those properties from the class specified in ClassName that are displayed in the results pane. The specified property names form the column heading in the results pane.

  • ResultPropertyIDName
    Data type: string
    Access type: Read/write

    Not used for user-defined nodes. Name of the property to be used in the WHERE clause of the result query. This limits the result instances, shown in the results pane for the selected node, to those whose property value equals the property value of the selected node.

    For example, the Manufacturer node under Software groups software by the CompanyName value (CompanyName is a property of SMS_G_System_SoftwareProduct). When a particular manufacturer is selected, the results pane shows the software products for that manufacturer.

  • ScopePropertyIDName
    Data type: string
    Access type: Read/write

    Not used for user-defined nodes. Name of a property from the class specified in ClassName. The value of this property is used for the name of child nodes in the scope pane. If the property is blank, the child nodes use the NodeName value.

  • ScopePropertyNames
    Data type: string[]
    Access type: Read/write

    Not used for user-defined nodes. List of property names whose values are concatenated to form the name of the node in the scope pane. This property has similar functionality and applies the same rules as the ResultProperties property, except the result is the name of the node. The concatenation creates a space between each value field. If this property is blank, then the child node uses the NodeName value.

Remarks

The Resource Explorer uses the following steps to determine the text to use for the column names. Each step is skipped in turn if the qualifier does not exist.

  1. Use the resource string identified by the ResID and ResDLL qualifiers.
  2. Use the string identified by the DisplayName qualifier.
  3. Use the property name itself.

See Also

Customizing the Resource Explorer, Resource Management Classes