C# Signature:

[DllImport("coredll.dll", SetLastError = true, CharSet = CharSet.Auto)]
    private static extern uint RasEnumConnections(
        [In, Out] RASCONN[] rasconn,
        [In, Out] ref int cb,
        [Out] out int connections);

VB Signature:

None.

User-Defined Types:

None.

Alternative Managed API:

Do you know one? Please contribute it!

Notes:

None.

Tips & Tricks:

Please add some!

Sample Code:

private const int SUCCESS = 0;

private const int ERROR_NOT_ENOUGH_MEMORY = 8;

private const int RASBASE = 600;

private const int ERROR_BUFFER_TOO_SMALL = RASBASE + 3;

private const int ERROR_INVALID_SIZE = RASBASE + 32;

public static RASCONN[] GetAllConnections()

    {
        RASCONN[] tempConn = new RASCONN[1];
        RASCONN[] allConnections = tempConn;

        tempConn[0].dwSize = Marshal.SizeOf(typeof(RASCONN));
        int lpcb = tempConn[0].dwSize;
        int lpcConnections = 0;
        uint ret = RasEnumConnections(tempConn, ref lpcb, out lpcConnections);
        if (ret == ERROR_INVALID_SIZE)
        {
        throw new Exception("RAS: RASCONN data structure has invalid format");
        }
        else if (ret == ERROR_BUFFER_TOO_SMALL && lpcb != 0)
        {
        // first call returned that there are more than one connections
        // and more memory is required
        allConnections = new RASCONN[lpcb / Marshal.SizeOf(typeof(RASCONN))];
        allConnections[0] = tempConn[0];
        ret = RasEnumConnections(allConnections, ref lpcb, out lpcConnections);
        }

        // Check errors
        if (ret != SUCCESS)
        {
        throw new Exception("RAS returns error: " + ret);
        }
        if (lpcConnections > allConnections.Length)
        {
        throw new Exception("RAS: error retrieving correct connection count");
        }
        else if (lpcConnections == 0)
        {
        allConnections = new RASCONN[0];
        }

        return allConnections;
    }

Please edit this page!

Do you have...

• helpful tips or sample code to share for using this API in managed code?
• corrections to the existing content?
• variations of the signature you want to share?
• additional languages you want to include?

Select "Edit This Page" on the right hand toolbar and edit it! Or add new pages containing supporting types needed for this API (structures, delegates, and more).