RASCONN

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

typedef struct _RASCONN { 
  DWORD     dwSize; 
  HRASCONN  hrasconn; 
  TCHAR     szEntryName[RAS_MaxEntryName + 1]; 
 
#if (WINVER >= 0x400) 
  TCHAR    szDeviceType[ RAS_MaxDeviceType + 1 ]; 
  TCHAR    szDeviceName[ RAS_MaxDeviceName + 1 ]; 
#endif 
#if (WINVER >= 0x401)
  TCHAR    szPhonebook [ MAX_PATH ];
  DWORD    dwSubEntry;
#endif 
#if (WINVER >= 0x500)
  GUID     guidEntry;
#endif
} RASCONN ; 

Members

dwSize

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

hrasconn

Specifies the remote access connection. This handle is used in other remote access API calls.

szEntryName

A 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

Windows NT 4.0 and later: A null-terminated string that contains the device type through which the connection is made.

szDeviceName

Windows NT 4.0 and later: A null-terminated string that contains the device name through which the connection is made.

szPhonebook [ MAX_PATH ]

Windows NT 4.0 and later: The full path and file name to the phone book containing the entry for this connection.

dwSubEntry

Windows NT 4.0 and later: For multilink connections, specifies the subentry index of one of the connected links. Subentry indices are one based.

guidEntry

Windows 2000: 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.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Ras.h.
  Unicode: Declared as Unicode and ANSI structures.

See Also

Remote Access Service (RAS) Overview, Remote Access Service Structures, RasEnumConnections, RasGetConnectStatus