This object is the root of a foundation of objects that allow the NSBasic application to obtain information and control the Remote Access Connections (RAS) of the system/device. You need to create only this object (NSBasic.win32.RAS), the other objects from the RAS foundation are obtained/created by the its members.

While internally the RAS object and the RASEntry objects are able to query the state of the entry (connected or not for instance), be sure to pay attention to the RASEntry members reference in order to ensure that you know when and how the state of the represented RAS entry is current. For example if you obtain a RASEntry object it represents the entry state at the moment in which you have obtained the object. If you keep the object for some time the state of the corresponding RAS entry may change because another application uses it. Use RASEntry.ResetState whenever you need to be absolutely sure that the RASEntry object "knows" what is currently happening with the RAS entry it represents. If you omit this step you may for example attempt to dial already connected entry.

Notes 

Currently the RAS objects foundation represents the most common RAS phone book features in all the Windows versions. In future the foundation may be extended to support additional features - such as specifying the RAS device settings and so on. The objects are written with this in mind and compatibility of any NSBasic code that uses them with future versions is guaranteed.

Members reference

Name	Syntax	Description
PhoneBook	object.PhoneBook = value variable = object.PhoneBook	By default it is empty which means "the default phone book". Some OS versions support different phonebooks and you can specify the file name of a non-default phonebook in this property. Before using it consult the OS version/variant documentation to see if this it supports custom phonebooks.  If you do not have special reason to deal with custom phonebooks leave the property empty - i.e. do not change it.
Version	variable = object.Version	Returns the object version
Entry	objEntry = object.Entry(EntryName)	Returns RASEntry object representing the RAS entry specified by the EntryName from the current phonebook (see PhoneBook).
Entries	object = object.Entries For Each Entry In object.Entries	Returns a collection of RASEntry objects with all the entries in the current phonebook (see PhoneBook).
Connections	object = object.Connections For Each Entry In object.Connections	Returns a collection of RASEntry objects currently active connections (connected or in connecting but in intermediate or erroneous state). You can think of it as of a collection of the connected RAS phonebook entries.