listUserSpaceRestrictions (user)

Lists the user space restrictions for n number of users, based on the last user information stored provided.

Request

<list>
   <volumeName/>
   <lastUserID/>
   <numEntries/>
   <allUsers/>   
</list>

Reply

<list>
<userList>
      <user>
         <id/>
         <userName/>
         <quota/>
         <spaceUsed/>
      </user>
   </userList>
   <result value="">
      <description/>
   </result>
</list>

Elements

volumeName: (Required) Specifies the volume's name to which to add a user space restriction.
lastUserID: Specifies the unique ID of the last user. Either the user's ID or name must be specified. Passing of an invalid GUID 00000000-0000-0000-00-00-000000000000 indicates that the user ID should begin with the first user
numEntries: Specifies the numebr of entries from the last user ID.
allUsers: (Optional) Specifies to return all users that are using storage but have no restrictions. Thisfunctionality is useful in listing the storage in use for all users.
fullyRestricted: Specifies that the user is limited to no more space.
noQuota: Specifies that the user has no limit.
result: Specifies an error value or 0 (for no error).
description: Specifies a text description of the result.

Example

A userRequest packet to list user quota for a volume is as follows:

<userRequest>
   <userQuota>
      <list>
         <volumeName><![CDATA[VOL2]]></volumeName>
         <lastUserID>00000000-0000-0000-00-00-000000000000</lastUserID>
         <numEntries>20</numEntries>
      </list>
   </userQuota>
 </userRequest>

A userReply packet to list user quota for a volume is as follows:

<userReply>
   <userQuota>
      <list>
         <userList>
            <user>
              <id>ab959229-a26c-4c58-16-ba-299295ab6ca2</id>
              <userName>wwwrun.novell</userName>
              <quota>1048576</quota>
              <spaceUsed>0</spaceUsed>
            </user>
         </userList>
   <result value="0">           
      <description/>zOK</description>            
   </result>
      </list>
    </userQuota>
</userReply>