<div class="content" name="R_WinsBackup" uuid="304d718f-5d5c-4ceb-b7e7-68deac3dc703"><p>The R_WinsBackup method backs up the <a href="a83205a2-23e2-41bb-84e1-4d968aaae4e8#gt_bafb050b-b593-4517-8093-f721bd2378ac" data-linktype="relative-path">WINS</a> database to a
specified directory.</p><dl>
<dd>
<div><pre> DWORD R_WinsBackup(
   [in] handle_t ServerHdl,
   [in, string, ref] LPBYTE pBackupPath,
   [in] SHORT fIncremental
 );
</pre></div>
</dd></dl><p><b>ServerHdl: </b>An <a href="a83205a2-23e2-41bb-84e1-4d968aaae4e8#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a> binding over IP
address/HostName to the WINS server. RPC uses this binding internally to
determine which WINS server the call is directed to.</p><p><b>pBackupPath: </b>A pointer to a string that
contains the name of the directory to which to back up the database. This
pointer MUST not be NULL.</p><p><b>fIncremental: </b>A value that is ignored.</p><p><b>Return Values: </b>A 32-bit unsigned integer that
indicates the return status. A return value of ERROR_SUCCESS (0x00000000)
indicates that the operation completed successfully. Any nonzero return value
is a Win32 error code, as specified in <a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a>.
The following Win32 error codes can be returned.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x00000000 ERROR_SUCCESS</td>
  <td>The call was successful.</td>
 </tr><tr>
  <td>0x00000FA0 ERROR_WINS_INTERNAL</td>
  <td>An error occurred while processing the RPC call.</td>
 </tr><tr>
  <td>0x00000FA4 ERROR_FULL_BACKUP</td>
  <td>The backup failed. Check the directory to which you are backing up the database.</td>
 </tr><tr>
  <td>0x00000005 ERROR_ACCESS_DENIED</td>
  <td>The caller doesn&#39;t have sufficient permissions.</td>
 </tr></tbody></table>
</dd></dl><p><b>Exceptions Thrown:</b> No exceptions are thrown beyond
those thrown by the underlying RPC protocol <a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a>.</p><p><b>Processing and Response Requirements:</b></p><p>The following requirements and recommendations apply to a
WINS server that processes a call to <a href="e231089b-eb49-40d2-8b62-2b1437e9f98a" data-linktype="relative-path">R_WinsBackup</a>:</p><ul><li><p><span><span> 
</span></span>The R_WinsBackup caller SHOULD have control level access. If an
RPC client with a lower access level calls this method, the server SHOULD
return ERROR_ACCESS_DENIED.</p>
</li><li><p><span><span> 
</span></span>The server returns ERROR_WINS_INTERNAL if <i>pBackupPath</i>
points to a string that is longer than 255 characters.</p>
</li><li><p><span><span> 
</span></span>The database is always backed up to the path specified by <i>pBackupPath</i>
with the string &#34;\wins_bak\&#34; appended. If the client doesn&#39;t have
sufficient permissions to create files in the specified directory or if the
backup fails for any other reasons, the server SHOULD return an
ERROR_FULL_BACKUP error.</p>
</li></ul></div>