Visual Studio .NET 2003Windows 2003.NET 1.1Windows 2000Windows XPIntermediateDevVisual StudioWindows.NETC#
Map Network Drive (API)






4.64/5 (61 votes)
Class for interfacing to the "map network drive" windows interface
What does it do?
This is a class for interfacing with windows map network drive API's.
Introduction to the class...
Getting started
Add the class file "cNetworkDrives0015.cs" to your project / solution.
Add the "using" definition to your form, etc.
using aejw.Network;
Example (Mapping a network drive)
NetworkDrive oNetDrive = new aejw.Network.NetworkDrive(); try{ oNetDrive.LocalDrive = "m:"; oNetDrive.ShareName = "\\ComputerName\Share" oNetDrive.MapDrive(); }catch(Exception err){ MessageBox.Show(this,"Error: "+err.Message); } oNetDrive = null;
Example (Unmapping a network drive)
NetworkDrive oNetDrive = new aejw.Network.NetworkDrive(); try{ oNetDrive.LocalDrive = "m:"; oNetDrive.UnMapDrive(); }catch(Exception err){ MessageBox.Show(this,"Error: "+err.Message); } oNetDrive = null;
Username and Password functions...
The following examples require the object / class to be declared. cNetworkDrive oNetDrive = new cNetworkDrive();
Mapping a network drive
//Map drive with current user credentials oNetDrive.LocalDrive = "m:"; oNetDrive.ShareName = "\\ComputerName\Share1" oNetDrive.MapDrive();
//Map drive with specified user credentials oNetDrive.LocalDrive = "m:"; oNetDrive.ShareName = "\\ComputerName\Share1" oNetDrive.MapDrive("Bob_Username","Bob_Password");
//Map drive with and prompt user for credentials oNetDrive.LocalDrive = "m:"; oNetDrive.ShareName = "\\ComputerName\Share1" oNetDrive.PromptForCredentials = true; oNetDrive.MapDrive();
//Map drive using a persistent connection oNetDrive.LocalDrive = "m:"; oNetDrive.Persistent = true; oNetDrive.SaveCredentials = true; oNetDrive.ShareName = "\\ComputerName\Share1" oNetDrive.MapDrive("Bob_Username","Bob_Password");
Unmapping a network drive
//Unmap a network connection oNetDrive.LocalDrive = "m:"; oNetDrive.ShareName = "\\ComputerName\Share1" oNetDrive.UnMapDrive();
//Unmap a network connection ignoring network related errors oNetDrive.LocalDrive = "m:"; oNetDrive.Force = true; oNetDrive.ShareName = "\\ComputerName\Share1" oNetDrive.UnMapDrive();
Other functions
//Display windows connection dialog oNetDrive.ShowConnectDialog(this); //Display windows disconnection dialog oNetDrive.ShowDisconnectDialog(this);
//Restore all persistent connections oNetDrive.RestoreDrives();
History
- 14th May 2004 - build0015
LocalDrive
andShareName
are now properties.- Dialog functions now use a form object instead of a window handle.
- Renaming scheme for public functions and properties,
MapNetworkDrive(...)
is nowMapDrive(...)
, etc... - Added
Persistant
option, Used for reconnecting a drive at logon. - Added
SaveCredentials
option, Allows windows to remember the user credentials when reconnecting a persistent connection. - Added
Force
option, forMapDrive
calls, if a drive is connected it will disconnect that drive then reconnect to the new share. - Added
PromptForCredintals
option, forMapDrive
calls, windows will ask for a username and password to use with the connection. - Added
RestoreDrives
function that restores persistent connections.
- 30th April 2004 - build0012
- Code refinements and tidying, added comments to the class.
- 27th April 2004 - build0011
- Adjusted declare tags, tidied class and article
- 26th April 2004 - build0010
- First version posted online