2.2.1.9.1 Element-Specific Attributes

Attribute name

Description

action

(optional) If specified, the value MUST be C, D, R, or U, corresponding to Create, Delete, Replace, and Update. If unspecified, the default value is U.

Create: This action MUST be used to create and configure a new property in an .ini or .inf file for computers or users. If the file does not exist, it MUST be created. If the property already exists, then a new property MUST NOT be created, and an error MUST NOT be returned.

Delete: This action MUST be used to remove a property or section from an .ini or .inf file, or to delete an .ini or .inf file for computers or users. If the property does not exist, then the client MUST NOT perform an action, and an error MUST NOT be returned.

Replace: This action MUST be used to delete and re-create a property in an .ini or .inf file for computers or users. The net result of the Replace action MUST be to delete the contents of an existing property and to overwrite the property. If the property does not exist, then the Replace action MUST create a new property.

Update: This action MUST have the same effect as Replace.

path

MUST be the fully qualified UNC path or a local path to an .ini or .inf format file from the perspective of the client, and MUST NOT include quotation marks. If the file and parent folders do not exist, they MUST be created, except in the case of a Delete operation.

section

(optional) MUST be the name of the section within the file in which to configure a property or from which to delete a property. To delete the entire .ini or .inf file, this field MUST be blank during a Delete operation.

value

(optional) MUST be a value for the property. Values can include quotation marks, but quotation marks are typically removed from the values when they are read by an application or the operating system. All values MUST be interpreted as text. This option applies only if the action selected is Create, Replace, or Update. If this field is left blank, the property MUST be configured with an empty value, which is interpreted as if the property did not exist.

property

(optional) MUST be the name of the property to configure or delete. To delete the entire section of the file or the entire file, leave this field blank.