setDfsGUID

Assigns a DFS GUID to a volume. If you specify an exact DFS GUID, it is stored as specified. Otherwise, if you specify the dfsGUID element with no content, a DFS GUID is generated for you by setDfsGUID.

Request

<setDfsGUID>
   <volumeName/>
   <dfsGUID/>
</setDfsGUID>

Reply

<setDfsGUID>
   <dfsGUID/>
   <result value=" ">
      <description/>
   </result>
</setDfsGUID>

Elements

volumeName: Specifies the volume on which to set the GUID.
dfsGUID: (Required) Specifies the GUID. If NULL is specified, a DFS GUID is generated.
result: Specifies an error value or 0 (for no error).
description: Specifies a text description of the result.

Example

A nssRequest packet to set the GUID is as follows:

<nssRequest>
   <dfs>
      <setDfsGUID>
         <volumeName>NSS1</volumeName>
         <dfsGUID>
      </setDfsGUID>
   </dfs>
</nssRequest>

A nssReply packet to the set DFS GUID command follows:

<nssReply>
   <dfs>
      <setDfsGUID>
          <dfsGUID>C212F8B4-3223-01D6-80-00-FBDA22AE6917
          </dfsGUID>
          <result value="0">
             <description/>success</description>
          </result>
      </setDfsGUID>
   </dfs>

   <result value="0">
      <description/>zOK</description>
   </result>
</nssReply>