3.1.4.13 R_WinsWorkerThdUpd (Opnum 12)
The R_WinsWorkerThdUpd method updates the number of threads that have been created to serve NetBIOS requests.
-
DWORD R_WinsWorkerThdUpd( [in] handle_t ServerHdl, [in] DWORD NewNoOfNbtThds );
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.
NewNoOfNbtThds: New value for the number of worker threads that have been created for NetBIOS requests.
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.
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_WinsWorkerThdUpd:
The R_WinsWorkerThdUpd 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.
The WINS service MUST be in the running or paused state for this method to succeed. If the service is in the initializing or exiting state, the server SHOULD return ERROR_WINS_INTERNAL.
The new number given in NewNoOfNbtThds MUST be in the range 2 through 19, inclusive. Otherwise, the server SHOULD return an ERROR_WINS_INTERNAL error.
The R_WinsWorkerThdUpd call sets the number of worker threads that serve NetBIOS requests to the new number given in NewNoOfNbtThds. If the existing number of NetBIOS threads is same as the requested number, the RPC call SHOULD return immediately. Otherwise, NetBIOS threads are created or deleted to adjust the total number of threads to the requested number.