Share via

3.3.4.7 RasRpcGetVersion (Opnum 15)

  • Article

The RasRpcGetVersion method retrieves the Rasrpc server interface version.

 DWORD RasRpcGetVersion(
   [in] handle_t h,
   [in, out, ref] LPDWORD pdwVersion
 );

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

pdwVersion: This is a pointer to type DWORD which, after a successful function call, specifies the version of the Rasrpc interface.

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

ERROR_SUCCESS

0x00000000

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

The opnum field value for this method is 15.

When processing this call, the RRAM server 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.<349>

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

  • Set the value pointed by pdwVersion to the version of RRAS server.<350>

  • If there is no error, the server MUST return ERROR_SUCCESS (0x00000000).