modifyLink

Renames or changes the contents of a link file. The newName element is optional and allows the file to be renamed. If a file is being renamed, the contents elements (junction, symlink, unc, or url) are not necessary. However, by including these elements, you can rename and modify the contents of a link file in the same call to modifyLink.

Request

<modifyLink>
   <pathName/>
   <newName/>
   <junction>
      <managementContext>
         <ndsObject/>
         <tgtTree/>
      </managementContext>
      <dfsGUID/>
      <ndsVolume>
         <ndsObject/>
         <tgtTree/>
      </ndsVolume>
      <volumeInfo>
          <server/>
          <tgtTree/>
          <volumeName/>
      </volumeInfo>
   </junction>
   <symlink>
      <nameSpace/>
      <pathName/>
   </symlink>
   <unc>
      <pathName/>
   </unc>
   <url>
      <pathName/>
   </url>
</modifyLink>

Reply

<modifyLink>
   <result value="">
      <description/>
   </result>
</modifyLink>

Elements

pathName: Specifies the link file to modify.
newName: (Optional) Specifies the new name of the file.
tgtTree: (Optional)
result: Specifies an error value or 0 (for no error).
description: Specifies a text description of the result.

Example

<nssRequest>
   <dfs>
      <modifyLink>
         <pathName>VOL1:\foo\junction</pathName>
         <newName>VOL1:\foo\newjunc</newName>

         <junction>          <!-- Modifying a junction -->
            <managementContext>
               <ndsObject>nss.prv.novell</ndsObject>
               <tgtTree>novell_inc</tgtTree>
            </managementContext>
            <dfsGUID>C2EAAA00-3211-11D6-B7-C7-00C04FA33547</dfsGUID>
            <ndsVolume>
               <ndsObject>VLDB-MASTER_VOL1.novell</ndsObject>
               <tgtTree>novell_inc</tgtTree>
            </ndsVolume>
            <volumeInfo>
               <server>vldb-master.novell</server>
               <tgtTree>novell_inc</tgtTree>
               <volumeName>VOL1</volumeName>
            </volumeInfo>
         </junction>

         <symlink>           <!-- Modifying a symbolic link -->
            <nameSpace>long</nameSpace>
            <pathName>abc/def</pathName>
         </symlink>

         <unc>               <!-- Modifying a UNC link -->
            <pathName>\\ServName\VolName\foo.bar</pathName>
         </unc>

         <url>               <!-- Modifying a URL link -->
            <pathName>http://nss.provo.novell.com/dfs</pathName>
         </url>
      </modifyLink>
   </dfs>
</nssRequest>