2.1.2.6 i

The i (item) complex type describes a file or folder that is being shared by a HomeGroup user in a HomeGroup machine on the HomeGroup.

 <xs:element name="i" minOccurs="1" 
 maxOccurs="unbounded">
   <xs:complexType>
     <xs:annotation>
       <xs:documentation>item, sub elements are path (absolute UNC or machine relative), display name and BASE-64 encoded serialized shell link</xs:documentation>
     </xs:annotation>
     <xs:all> 
         <xs:element name="p" type="xs:anyURI"/>
         <xs:element name="dn" type="xs:string" minOccurs="0" />
         <xs:element name="sl" type="serializedType"/>
         <xs:element name="ul" type="ul" minOccurs="0" />
     </xs:all> 
   </xs:complexType>
 </xs:element>

p: An absolute UNC path or a relative machine path to the shared file or folder. If the path begins with a "\" then it is a machine-relative path. Relative paths are related to the HomeGroup machine where the message originated. The machine name is taken from the WSD Shell Publishing message that is transporting this data structure.

This element is used to access the shared resource if the shell link element pi.usersFilesDescription.il.i.sl is not present or if the HomeGroup machine originating the message has changed since the link was created.

dn: Optional element. When present, contains the display name of the item. The display name is sent so that if the message client implementation uses the display name, it is unnecessary to use additional protocols to retrieve the display name.

sl: A base-64-encoded binary stream representing a serialized shell link. The shell link references a file or folder shared by the HomeGroup user on the machine and contains the associated item ID list. This information is sent so that if the implementation uses the item ID list, it is unnecessary to use additional protocols to retrieve the ID list. Shell Links are specified in [MS-SHLLINK].

This field uses nonstandard base-64 encoding as specified in section 2.1.4.2.

ul: Optional element. When present, contains the users list. This is a list of Internet SIDs (security identifiers) that identifies the users that have discretionary access to a shared item. This list SHOULD only be included if the user is sharing out items by using discretionary access.