list Element

Applies To: Windows Server 2008

The list element sets a list of different registry subkeys when a policy setting is enabled through the Local Group Policy Editor or Group Policy Management Console. The list element is generally associated with a show box parameter in the Local Group Policy Editor or GPMC.

<list    id="<placeholderID>"
         explicitValue="true|false" >


Attributes Required Description

id Attribute


A mapping to the list element.

clientExtension Attribute


The client-side extension will process, on the client computer, the particular settings represented by the list element.

key Attribute


The registry key location under which the registry value will be created.

valuePrefix Attribute


The prefix prepended to an incremented integer will create the registry sub-key used in setting policy values.

additive Attribute


If this option is specified true, existing subkeys are not deleted, and the values set in the list box are appended to the existing subkeys.

expandable Attribute


The registry subkey value will be created as an expandable string type (REG_EXPAND_SZ) instead of a string type (REG_SZ).

explicitValue Attribute


If this option is specified true the user must specify the registry subkey value and the registry subkey name. The list box shows two columns, one for the name and one for the data.

There are no child elements associated with this element.

The list element will require a matching listBox element in the corresponding .adml file with id that matches as declared in the list element.

This XML fragment is an example of using a list element to create a one-column list box for parameter entry. Each registry subkey name will have "SAMPLE" prepended to its name.

        <list id="Sample_ListBox_SingleColumn_Param"
              valuePrefix="SAMPLE" />
If the valuePrefix attribute is not specified, the registry sub-key name will match the name of the value entered. If you want the registry sub-keys to be named with incremental integers only, set the valuePrefix attribute to a null value, valuePrefix="".

This XML fragment is an example of using a list element to create a two-column list box for parameter entry.

        <list id="Sample_ListBox_DoubleList"
              explicitValue="true" />

Community Additions