Share via


RASCONN structure

The RASCONN structure provides information about a remote access connection. The RasEnumConnections function returns an array of RASCONN structures.

Syntax

typedef struct _RASCONN {
  DWORD    dwSize;
  HRASCONN hrasconn;
  TCHAR    szEntryName[RAS_MaxEntryName + 1];
  TCHAR    szDeviceType[RAS_MaxDeviceType + 1];
  TCHAR    szDeviceName[RAS_MaxDeviceName + 1];
  TCHAR    szPhonebook[MAX_PATH ];
  DWORD    dwSubEntry;
  GUID     guidEntry;
  DWORD    dwFlags;
  LUID     luid;
  GUID     guidCorrelationId;
} RASCONN, *PRASCONN;

Members

  • dwSize
    Specifies the size, in bytes, of the RASCONN structure.

  • hrasconn
    A HRASCONN handle that defines the remote access connection. This handle is used in other remote access API calls.

  • szEntryName
    A null-terminated string that specifies the phone-book entry used to establish the remote access connection. If the connection was established using an empty entry name, this string consists of a PERIOD followed by the connection phone number.

  • szDeviceType
    A null-terminated string that contains the device type through which the connection is made. See RASENTRY for a list of possible device types.

  • szDeviceName
    A null-terminated string that contains the device name through which the connection is made.

  • szPhonebook
    A null-terminated string that specifies the full path and file name of a phone-book (PBK) file.

  • dwSubEntry
    For multilink connections, a value that specifies the subentry one-based index of a connected link.

  • guidEntry
    A GUID (Globally Unique IDentifier) that represents the phone-book entry. The value of this member corresponds to that of the guidId member in the RASENTRY structure.

    Note  This member is supported in Windows 2000 and later versions of Windows.

     

  • dwFlags
    A value that specifies zero or more of the following flags.

    Flags Meaning
    RASCF_AllUsers The connection is a "for-all-users" connection.
    RASCF_GlobalCreds The credentials used for this connection are the default credentials. For more information, see RASCM_DefaultCreds under RasSetCredentials.

     

    Note  This member is supported in Windows XP, Windows Server 2003 and later versions of Windows.

     

  • luid
    A locally unique identifier (LUID) that specifies the logon session of the RAS connection.

    Note  This member is supported in Windows XP, Windows Server 2003 and later versions of Windows.

     

  • guidCorrelationId
    A GUID that specifies the RAS connection correlation ID. The correlation ID is logged with the RAS connection setup, disconnect and setup failure events and identifies the RAS connection event logs on the client and server.

    Note  This member is supported in Windows Vista with SP1 and later versions of Windows.

     

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Ras.h

Unicode and ANSI names

RASCONNW (Unicode) and RASCONNA (ANSI)

See also

Remote Access Service Structures

RasEnumConnections