3.2.4.2 R_WinsCheckAccess (Opnum 1)

  • Article

The R_ WinsCheckAccess method retrieves the level of access the client is granted.<12>

 DWORD R_WinsCheckAccess(
   [in] handle_t ServerHdl,
   [out] DWORD* Access
 );

ServerHdl: An RPC binding over IP address/HostName to the WINS server. RPC uses this binding internally to resolve which WINS server the call is directed to.

Access: Pointer to the access level value. This value MUST not be NULL. The following values are possible as output.

Name

Value

No access

0

Control level access

1

Query level access

2

Return Values: A 32-bit unsigned integer value that indicates the return status. A return value of ERROR_SUCCESS (0x00000000) indicates that the operation completed successfully. Any other 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.

Exceptions Thrown: No exceptions SHOULD be thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].

Processing and Response Requirements:

Clients with any access level can call this method.