3.1.4.12 R_WinsResetCounters (Opnum 11)
The R_WinsResetCounters method resets the pull replication counters for all partners of the target WINS server.
-
DWORD R_WinsResetCounters( [in] handle_t ServerHdl );
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.
Return Values: A 32 bit unsigned integer that indicates the return status. A return value of ERROR_SUCCESS (0x00000000) indicates that operation completed successfully. A 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.
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_WinsResetCounters:
The R_WinsResetCounters 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.
Each WINS server maintains one WINSINTF_RPL_COUNTERS_T structure (section 2.2.2.5) per configured pull partner to track the number of successful pull replications and the number of communication failures. The R_WinsResetCounters method resets to zero the values of the NoOfRpls and NoOfCommFails members of the WINSINTF_RPL_COUNTERS_T structures for all the configured pull partners of the target WINS server.
This method MUST return ERROR_SUCCESS if the client has sufficient access level permissions.