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