list Element

Article
07/02/2012

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.

Syntax

<list    id="<placeholderID>"
         clientExtension="<placeholderGUID>"
         key="<placeholderRegKey>"
         valuePrefix="<placeholderName>"
         additive="true|false"
         expandable="true|false"
         explicitValue="true|false" >
</list>

Attributes

Attributes	Required	Description
id Attribute	Yes	A mapping to the list element.
clientExtension Attribute	No	The client-side extension will process, on the client computer, the particular settings represented by the list element.
key Attribute	No	The registry key location under which the registry value will be created.
valuePrefix Attribute	No	The prefix prepended to an incremented integer will create the registry sub-key used in setting policy values.
additive Attribute	No	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	No	The registry subkey value will be created as an expandable string type (REG_EXPAND_SZ) instead of a string type (REG_SZ).
explicitValue Attribute	No	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.

Child elements

There are no child elements associated with this element.

Remarks

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

Examples

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"
              key="Software\Policies\Examples\listbox1"
              valuePrefix="SAMPLE" />

Note

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"
              key="Software\Policies\Examples\listbox2"
              explicitValue="true" />

Additional references

elements Element

listBox Element

Partager via