RasUpdateConnection function (ras.h)

Article
10/13/2021

The RasUpdateConnection function updates the tunnel endpoints of an Internet Key Exchange version 2 (IKEv2) connection.

Syntax

DWORD RasUpdateConnection(
  [in] HRASCONN        hrasconn,
  [in] LPRASUPDATECONN lprasupdateconn
);

Parameters

[in] hrasconn

A handle to the IKEv2 RAS connection for which the tunnel endpoints are to be changed. This can be a handle returned by the RasDial or RasEnumConnections function.

[in] lprasupdateconn

A pointer to a RASUPDATECONN structure that contains the new tunnel endpoints for the RAS connection specified by hrasconn.

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value is one of the error codes from Routing and Remote Access Error Codes or Winerror.h.

Remarks

Note that 32-bit applications that call RasUpdateConnection will fail when run on a 64-bit machine. The workaround is to write a 64-bit version of the application for 64-bit machines.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	ras.h
Library	Rasapi32.lib
DLL	Rasapi32.dll