The RasHangUp function terminates a remote access connection. The connection is specified with a RAS connection handle. RasHangUp releases all RASAPI32.DLL resources associated with the handle.

DWORD RasHangUp(
HRASCONN Session );


  • Session
    Handle to the remote access connection to terminate. This is a handle returned from a previous call to RasDial or RasEnumConnections.

Return Values

Zero indicates success. A nonzero error value listed in the RAS header file or ERROR_INVALID_HANDLE indicates failure.

Include Raserror.h for definitions of the RAS error codes.


The connection is terminated even if the RasDial call has not yet been completed.

After this call, the Session handle can no longer be used.


Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Ras.h, Afdfunc.h   Ppp.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

RASCONN, RasDial, RasEnumConnections, RasGetConnectStatus, Sleep

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.