windows-server-2003/drivers/storage/volsnap/vss/modules/backupext/componentmetadata.xml

<Schema name="VssComponentMetadata"
        xmlns="urn:schemas-microsoft-com:xml-data"
	xmlns:dt="urn:schemas-microsoft-com:datatypes">


<AttributeType name="filespec" dt:type="string" required="yes">
   <description>
   File specification.  Can include wildcard characters ? and *
   </description>
</AttributeType>

<AttributeType name="path" dt:type="string" required="yes">
   <description>
   Path to a file.  The path can include environment variables or
   values extracted from registry keys.
   </description>
</AttributeType>


<AttributeType name="recursive" dt:type="enumeration"
               dt:values="yes no" default="no">
   <description>
   Is path specified recursive or limited to the directory that is specified.
   </description>
</AttributeType>

<AttributeType name="alternatePath" dt:type="string" required="no">
   <description>
   Alternate path in which to find the file.  Files in a file group may
   have been copied to an alternative location by the writer.  Backup should
   pick up the files from the alternative location instead of the original
   location but should restore the files to their original location
   </description>
</AttributeType>

<AttributeType name="logicalPath" dt:type="string" required="no">
   <description>
   Logical path for a database or file group.  This logical name uses backslash
   as separators to form a logical namespace hierarchy
   </description>
</AttributeType>

<AttributeType name="componentName" dt:type="string" required="yes">
   <description>
   Name used to identify a database or file group.  May be qualified by a
   logical path.
   </description>
</AttributeType>


<AttributeType name="version" dt:type="enumeration" dt:values="1.0" required="yes">
   <description>
   Version of a specific document
   </description>
</AttributeType>

<AttributeType name="writerId" dt:type="uuid" required="yes">
   <description>
   Unique id to identify the writer.  Note that this identifies the
   writer class rather than a specific instance of the writer.
   </description>
</AttributeType>

<AttributeType name="instanceId" dt:type="uuid" required="no">
   <description>
   Unique id identifying the instance of a writer during backup.  It
   has no meaning during restore.
   </description>
</AttributeType>


<ElementType name="BACKUP_COMPONENTS" content="eltOnly" model="closed" order="many">
   <description>
   Components that are backed up or restored.
   Used to communicate between the writer and the backup application during
   backup and restore.
   </description>

   <AttributeType name="selectComponents" dt:type="enumeration"
                       dt:values="yes no" default="no">
      <description>
      Does the backup application select individual components or
      does it backup entire volumes
      </description>
   </AttributeType>

   <AttributeType name="bootableSystemStateBackup" dt:type="enumeration"
		  dt:values = "yes no" default="no" >
      <description>
      Is backup saving the bootable state of the system.
      </description>
   </AttributeType>

   <AttributeType name="backupType" dt:type="enumeration"
                  dt:values="full differential incremental other"
		  required="yes">
      <description>
      Type of backup being performed.
      </description>
   </AttributeType>

   <attribute type="version" />
   <attribute type="selectComponents" />
   <attribute type="bootableSystemStateBackup" />
   <attribute type="backupType" />

   <element type= "WRITER_COMPONENTS" />
</ElementType>

<ElementType name="WRITER_COMPONENTS" content="eltOnly" model="closed"
             order="many">
   <description>
   Components that are backed up and restored that are associated with a
   specific writer instance
   </description>

   <attribute type="writerId" />
   <attribute type="instanceId" />

   <element type="COMPONENT" />
</ElementType>

<ElementType name="COMPONENT" content="eltOnly" model="open" order="many">
   <AttributeType name="backupSucceeded" dt:type="enumeration"
                  dt:values="yes no" default="no">
      <description>
      Indication of whether the component was backed up successfully
      or not.  This should be set during the BackupComplete notification
      </description>
   </AttributeType>

   <AttributeType name="componentType" dt:type="enumeration"
                  dt:values="database filegroup">
       <description>
       Indication of whether component is database or file group
       </description>
   </AttributeType>

   <attribute type="componentType" />
   <attribute type="logicalPath" />
   <attribute type="componentName" />
   <attribute type="backupSucceeded" />

   <element type="BACKUP_METADATA" minOccurs="0" maxOccurs="1" />
   <element type="ALTERNATE_LOCATION_MAPPING" minOccurs="0" maxOccurs="*" />

</ElementType>

<ElementType name="ALTERNATE_LOCATION_MAPPING" content="empty" model="closed">
  <description>
     Mapping from a location that was backed up to a location to restore to.
  </description>
   <attribute type="path" />
   <attribute type="filespec" />
   <attribute type="recursive" />
   <attribute type="alternatePath" />
</ElementType>


<ElementType name="BACKUP_METADATA" content="empty" model="closed">
   <description>
   Default metadata element for backup.  Content is a binary hex string.
   Note that the writer can store whatever he wants in the component.  This
   is just a simple default mechanism.
   </description>

   <AttributeType name="metadata" dt:type="string" required="yes">
      <description>
      Metadata to be passed on restore
      </description>
   </AttributeType>

   <attribute type="metadata" />
</ElementType>


</Schema>