3.1.4.11 R_WinsSetPriorityClass (Opnum 10)

 The R_WinsSetPriorityClass method sets the priority class for the WINS process running on the target WINS server.

 DWORD R_WinsSetPriorityClass(
   [in] handle_t ServerHdl,
   [in] WINSINTF_PRIORITY_CLASS_E PrCls_e
 );

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.

PrCls_e: The priority class to be set.

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

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_WinsSetPriorityClass:

  • The R_WinsSetPriorityClass 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 PrCls_e is set to a value other than WINSINTF_E_NORMAL or WINSINTF_E_HIGH, the server SHOULD return ERROR_WINS_INTERNAL.

  • The server sets the priority class of the WINS process to the one specified by PrsCls_e.