Share via

3.3.4.3 RasRpcSetUserPreferences (Opnum 10)

  • Article

The RasRpcSetUserPreferences method sets the configuration information. The configuration information consists of the callback information associated with the various ports, and the number of the last successful callback done by the RRAS.

 DWORD RasRpcSetUserPreferences(
   [in] handle_t h,
   [in] LPRASRPC_PBUSER pUser,
   [in] DWORD dwMode
 );

h: An RPC binding handle as specified in [C706] section 2.

pUser: Pointer to the RASRPC_PBUSER (section 2.2.1.2.229) structure which on successful return contains the configuration information on the RRAS server.

dwMode: This MUST be set to 2.

Return Values: Specifies the return status as explained in section 2.2.1.2.218 for the retcode field.

The return value can be one of the error codes that follow. All other error values MUST be treated the same by the RRASM client.

Return value/code

Description

0x00000000

ERROR_SUCCESS

The call was successful.

Exceptions Thrown: This method throws an exception with the exception code RPC_S_ACCESS_DENIED (0x00000005) if the client is not an administrator on the RRASM server, with access permission to perform the operation.<337>

The opnum field value for this method is 10.

When processing this call, the RRASM SHOULD do the following:

  • Validate as specified in section 3.3.4 whether this method was called by a client that is an administrator of the RRASM server.

  • Call the abstract interface Invoke RASRPC method, specifying the operation and the parameters necessary to enable RRAS server to perform the required management task.

  • Provide the configuration information as specified by the pUser structure to the RRAS server for further processing and returning ERROR_SUCCESS (0x00000000).