NetOpenRemoteAccess (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Connection for the remote network access
Miscellaneous

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

NetOpenRemoteAccess (Function)

In french: NetOuvreAccèsDistant

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