<div class="content" name="R_WinsTombstoneDbRecs" uuid="dbb45b0b-c914-4bc3-9cb7-1931a1981446"><p>The R_WinsTombstoneDbRecs method <a href="a83205a2-23e2-41bb-84e1-4d968aaae4e8#gt_9d8e0963-13fa-4e19-a97f-7ce6bc90d20f" data-linktype="relative-path">tombstones</a> records whose
version numbers fall within a range of version numbers and are owned by a
server with a specified address.</p><dl>
<dd>
<div><pre> DWORD R_WinsTombstoneDbRecs(
   [in] handle_t ServerHdl,
   [in, ref] PWINSINTF_ADD_T pWinsAdd,
   [in] WINSINTF_VERS_NO_T MinVersNo,
   [in] WINSINTF_VERS_NO_T MaxVersNo
 );
</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 <a href="a83205a2-23e2-41bb-84e1-4d968aaae4e8#gt_f2f9c250-6c9e-445f-b677-376f23f77d87" data-linktype="relative-path">WINS
server</a>. RPC uses this binding internally to resolve which WINS server the
call is directed to.</p><p><b>pWinsAdd: </b>A pointer to the address of the <a href="a83205a2-23e2-41bb-84e1-4d968aaae4e8#gt_5adb42e6-46b8-4a71-b98c-f997bf00db61" data-linktype="relative-path">owner WINS server</a> whose
records are to be tombstoned. This value MUST NOT be NULL.</p><p><b>MinVersNo: </b>The lower bound on the range of
version numbers that identifies the range of records to be tombstoned.</p><p><b>MaxVersNo: </b>The upper bound on the range of
version numbers that identifies the range of records to be tombstoned.</p><p><b>Return Values: </b>A 32 bit unsigned integer value
that indicates the return status. A return value of ERROR_SUCCESS (0x00000000)
indicates that the operation completed successfully. Any other 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>0x00000005 ERROR_ACCESS_DENIED</td>
  <td>The caller does not have sufficient permissions.</td>
 </tr><tr>
  <td>0x00000FA0 ERROR_WINS_INTERNAL</td>
  <td>An error occurred while processing the RPC call.</td>
 </tr></tbody></table>
</dd></dl><p><b>Exceptions Thrown:</b> No exceptions SHOULD be 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 R_WinsTombstoneDbRecs:</p><ul><li><p><span><span> 
</span></span>The R_WinsTombstoneDbRecs 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>If the specified owner WINS server address is not found in the <a href="a83205a2-23e2-41bb-84e1-4d968aaae4e8#gt_57b996ea-5019-4e6e-8848-1f850bcac53d" data-linktype="relative-path">owner-version map</a> table,
the server SHOULD return ERROR_WINS_INTERNAL.</p>
</li><li><p><span><span> 
</span></span>If any error occurs during the retrieval or updating of database
records, the server SHOULD return ERROR_WINS_INTERNAL.</p>
</li><li><p><span><span> 
</span></span>The server changes the state of the matching records to
tombstoned. It also updates the version number and the ownership of these
records so that the version number and record ownership are replicated on the
partner WINS servers when replication takes place.</p>
</li><li><p><span><span> 
</span></span>The time stamp of the matching record is set to a string with the
following format:</p>
<div><pre> current time + tombstone timeout configured on the target WINS server
</pre></div>
</li><li><p><span><span> 
</span></span>If both <i>MinVersNo</i> and <i>MaxVersNo</i> are zero, all
records matching the given <a href="a83205a2-23e2-41bb-84e1-4d968aaae4e8#gt_fd7218ec-39b0-4372-bf4c-9ddfba81cb9e" data-linktype="relative-path">owner</a>
address are tombstoned.</p>
</li></ul></div>