3.1.4.20 R_WinsStatusNew (Opnum 19)

The R_WinsStatusNew method retrieves configuration settings and statistics from a WINS server.

 DWORD R_WinsStatusNew(
   [in] handle_t ServerHdl,
   [in] WINSINTF_CMD_E Cmd_e,
   [out] PWINSINTF_RESULTS_NEW_T pResults
 );

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.

Cmd_e: The command to be executed on the target WINS server, from the WINSINTF_CMD_E enumeration (section 2.2.1.5).

pResults: A pointer to a WINSINTF_RESULTS_NEW_T structure (section 2.2.2.11), which contains the results of the command execution.

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 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 behavior of this method is exactly same as that of R_WinsStatus except for the following:

    • There is no limit on the number of entries in the address-version map array.

    • This method SHOULD NOT be called with Cmd_e set to WINSINTF_E_ADDVERSMAP. If it is, the server returns an ERROR_WINS_INTERNAL error.

  • Refer to R_WinsStatus and WINSINTF_RESULTS_NEW_T for the details of the behavior of this method.