NetworkConnect (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.

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Network functions

Error codes
Use in Windows Vista (and later)

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

NetworkConnect (Function)

In french: RéseauConnecte

Associates a drive with a shared network directory.

Example

// Associe la lettre "E:" au répertoire réseau \\DocumentsPartagés\Fichiers
ResConnexion is int = NetworkConnect("E:", "\\DocumentsPartagés\Fichiers")

SWITCH ResConnexion 
	CASE 1
		Error("La connexion n'est pas supportée.")
	CASE 2
		Error("Il n'y a pas assez de mémoire disponible.")
	CASE 3
		Error("Mauvais pointeur.")
	CASE 4
		Error("Mauvais type de device.")
	CASE 5
		Error("Mauvais profil utilisateur.")
	CASE 7
		Error("Il y a déjà une entrée pour ce device dans le profil utilisateur (Déjà connecté)")
	CASE 8
		Error("Mauvais réseau ou mauvais chemin.")
	CASE 9
		Error("Pas de réseau.")
	CASE 10
		Error("Erreur réseau..")
	CASE 11
		Error("Mauvais nom de réseau.")
	CASE 12
		Error("La lettre du lecteur est invalide.")
	CASE 13
		Error("Mauvais mot de passe.")
	CASE 14
		Error("Accès refusé.")
	OTHER CASE
		Info("Lecteur créé avec succès")
END

Syntax

<Result> = NetworkConnect(<Drive letter> , <Network directory> [, <Options>] [, <User> [, <Password>]])

<Result>: Integer

0 if the connection was established
an error code (value greater than 0) otherwise.

<Drive letter>: Character string

Network drive to create, in the following format: "<Drive letter>:".

<Network directory>: Character string

Network directory that must be associated with the network drive.

<Options>: Optional Integer constant

Sets the persistence of the connection:
ncOptionNone No persistence option.
ncOptionPersistent
(default value) Persistent connection (the connection remains after restarting the computer).

<User>: Optional character string

Name of user allowed to access the specified directory. This parameter corresponds to Null by default.

<Password>: Optional string or Secret string

Password used to access the specified directory. If <User> corresponds to the name of the current user, the password is ignored by Windows. This parameter corresponds to an empty string ("") by default.
New in version 2025
Secret strings: If you use the secret string vault, the type of secret string used for this parameter must be "ANSI or Unicode string".
To learn more about secret strings and how to use the vault, see Secret string vault.

Remarks

Error codes

The following error codes are returned:

1: The connection is not supported.
2: Not enough memory available.
3: Wrong pointer.
4: Wrong device type (e.g. invalid drive letter).
5: Wrong user profile.
7: There is already an entry for this device in the user profile (Already logged in)
8: Wrong network or path.
9: No network.
10: Network error.
11: Wrong network name.
12: The drive letter is invalid.
13: Wrong password.
14: Access denied.

The message corresponding to the error code can be known using the ErrorInfo function with the constant errMessage.

Use in Windows Vista (and later)

In Windows Vista (and later), when the application is started in "Administrator" mode, the network connections may be lost for the application. If UAC system is enabled, the network drives are disconnected when the user privileges are increased. To be able to use the drives, you must reconnect them with NetworkConnect.

Business / UI classification: Business Logic

Component: wd300std.dll

See also

Minimum version required

Version 9

This page is also available for…

Comments

//Mapear , conectar e desconectar rede

//Mapear , conectar e desconectar rede

ResConnection is int= NetworkConnect("M:", "\\Marciano\d")
SWITCH ResConnection
CASE 1 : Error("A conexão não é suportada")
CASE 2 : Error("Memória insuficiente.")
CASE 3 : Error("ponteiro errado.")
CASE 4 : Error("tipo errado de dispositivo")
CASE 5 : Error("perfil de usuário errado.")
CASE 7 : Error("Uma entrada já é encontrada para este dispositivo no perfil do usuário (já conectado)")
CASE 8 : Error("Invalid network or wrong path.")
CASE 9 : Error("Sem rede.")
CASE 10 : Error("Erro de rede.")
CASE 11 : Error("Nome de rede errado.")
CASE 12 : Error("A letra da unidade é inválido.")
CASE 13 : Error("Senha incorreta.")
CASE 14 : Error("Acesso negado.")
OTHER CASE
Info("Conduzir criado com sucesso")
END

//Desconectar
nResDisconnect is int= NetworkDisconnect("M:")
SWITCH nResDisconnect
CASE 16
Error("valor errado para a desconexão")
CASE 17
Error("Conexão usada atualmente")
CASE 18
Error("Um arquivo é aberto, incapaz de desconectar")
CASE 19
Error("Tente desligar sem uma conexão")
OTHER CASE
Info("desconectado com sucesso")
END

//Blog com Video e Exemplo
http://windevdesenvolvimento.blogspot.com.br/2016/09/curso-windev-funcoes-windows-013.html
https://www.youtube.com/watch?v=De3VzI4l480

De matos

20 Sep. 2016

Last update: 05/16/2025

Send a report | Local help