3.1.4.9 R_WinsDelDbRecs (Opnum 8)

The R_WinsDelDbRecs method deletes the records whose version numbers are within a specified range and that are owned by a specified WINS server.

 DWORD R_WinsDelDbRecs(
   [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 determine which WINS server the call is directed to.

pWinsAdd: A pointer to an owner WINS server address whose records are to be deleted from the target WINS server.

MinVersNo: The lower bound on the version number of the records to be deleted.

MaxVersNo: The upper bound on the version number of the records to be deleted.

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

Return value/code

Description

0x00000000

ERROR_SUCCESS

The call was successful.

0x00000FA0

ERROR_WINS_INTERNAL

An error occurred while processing the RPC call.

0x00000005

ERROR_ACCESS_DENIED

The caller doesn't have sufficient permissions.

Exceptions Thrown: No exceptions are 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_WinsDelDbRecs:

  • The R_WinsDelDbRecs 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 target WINS server doesn't have any records owned by the WINS server whose address is specified by pWinsAdd, the server SHOULD return ERROR_WINS_INTERNAL.

  • Records are deleted from the target WINS server database if their version numbers fall between the values of MinVersNo and MaxVersNo and if they are owned by the WINS server whose address is specified in pWinsAdd.

  • If both MinVersNo and MaxVersNo are set to zero, all records owned by the WINS server whose address is specified in pWinsAdd are deleted.