PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
This content has been translated automatically. Click here to view the French version.
  • Connection for the remote network access
  • Miscellaneous
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Establishes a remote connection. This function can be used to handle the emails via the POP3 protocol on the remote server.
Remark: Then, the remote connection can be closed by NetCloseRemoteAccess.
Example
// Lance la connexion Internet sur un PC
// Le nom de la connexion à utiliser est celui défini dans la liste des
// connexions du PC (Panneau de configuration).
Rapport is int = NetOpenRemoteAccess("Connexion_LiveBox")
IF Rapport = 0 THEN
...
NetCloseRemoteAccess()
ELSE
Error("Erreur lors de la connexion", NetMsgError(Rapport))
END
// Ouverture de la connexion sur un Smartphone
sNomConnexion is string
nRetourCnx is int
// Le nom de la connexion est fourni par l'opérateur
sNomConnexion = "Bouygues Internet "
// Ouverture de la connexion
nRetourCnx = NetOpenRemoteAccess(sNomConnexion)
IF nRetourCnx = 0 THEN
// Traitement souhaité
// ...
NetCloseRemoteAccess(sNomConnexion)
ELSE
Error("Erreur lors de la connexion:", NetMsgError(nRetourCnx))
END
Syntax
<Result> = NetOpenRemoteAccess(<Access name> [, <Password>] [, <Automatic closing>])
<Result>: Integer
  • 0 if the connection was established,
  • an error code otherwise. This error code can be used with the NetMsgError function to find out the exact cause of the error and the corresponding message.
<Access name>: Character string
Name of "Remote network access" connection defined in Windows. The list of remote accesses installed on a computer is returned by NetListRemoteAccess.
If the connection is already enabled (if it was opened manually or by another application), it is automatically retrieved.
<Password>: Optional character string
Password associated with the connection.
<Automatic closing>: Optional boolean
  • True (default value): the connection will be automatically closed at the end of application or during the call to NetCloseRemoteAccess without parameter (valid for the last connection opened by NetOpenRemoteAccess).
  • False: the connection is not closed when the application is closed. Used, for example, to create an application that opens a connection. Similarly, NetCloseRemoteAccess without parameter will not close the connection. To close this connection, the access name must be passed in parameter.
Remarks

Connection for the remote network access

A connection for remote network access is created in the control panel of Windows. The following information is required to create the connection:
  • the name of the connection (used by the NetOpenRemoteAccessfunction),
  • the phone number to dial,
  • the user login,
  • the modem, the protocol, etc.
This information is supplied by the provider.
When the connection is run via a double click performed on the corresponding icon, you have the ability to specify a password for this connection. This password can be stored in order to be used whenever this connection is started.

Miscellaneous

  • Caution: The connection to a remote network can take quite a long time. The execution of the current application is locked during the entire duration of the connection.
  • A single connection can be opened at a given time.
  • It is advisable to check that the connection is working properly in Windows before running the NetOpenRemoteAccessfunction.
Component: wd270com.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment