3.2.4.1 R_WinsTombstoneDbRecs (Opnum 0)

  • Article

The R_WinsTombstoneDbRecs method tombstones records whose version numbers fall within a range of version numbers and are owned by a server with a specified address.

 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
 );

ServerHdl: An RPC binding over IP address/HostName to the WINS server. RPC uses this binding internally to resolve which WINS server the call is directed to.

pWinsAdd: A pointer to the address of the owner WINS server whose records are to be tombstoned. This value MUST NOT be NULL.

MinVersNo: The lower bound on the range of version numbers that identifies the range of records to be tombstoned.

MaxVersNo: The upper bound on the range of version numbers that identifies the range of records to be tombstoned.

Return Values: 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 [MS-ERREF]. The following Win32 error codes can be returned:

Return value/code

Description

0x00000000

ERROR_SUCCESS

The call was successful.

0x00000005

ERROR_ACCESS_DENIED

The caller does not have sufficient permissions.

0x00000FA0

ERROR_WINS_INTERNAL

An error occurred while processing the RPC call.

Exceptions Thrown: No exceptions SHOULD be thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].

Processing and Response Requirements:

The following requirements and recommendations apply to a WINS server that processes a call to R_WinsTombstoneDbRecs:

  • 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.

  • If the specified owner WINS server address is not found in the owner-version map table, the server SHOULD return ERROR_WINS_INTERNAL.

  • If any error occurs during the retrieval or updating of database records, the server SHOULD return ERROR_WINS_INTERNAL.

  • 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.

  • The time stamp of the matching record is set to a string with the following format:

     current time + tombstone timeout configured on the target WINS server

  • If both MinVersNo and MaxVersNo are zero, all records matching the given owner address are tombstoned.