Click here to Skip to main content
16,016,184 members
Articles / Programming Languages / C#
Article

Map Network Drive (API)

Rate me:
Please Sign up or sign in to vote.
4.64/5 (65 votes)
18 May 2004CC (ASA 2.5)1 min read 640.4K   21.2K   139   117
Class for interfacing to the "map network drive" windows interface

Image - netdrive0015.jpg

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.
    C#
    using aejw.Network;
  • Example (Mapping a network drive)

    C#
    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)

    C#
    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.
C#
cNetworkDrive oNetDrive = new cNetworkDrive();
  • Mapping a network drive

    • C#
      //Map drive with current user credentials
      oNetDrive.LocalDrive = "m:";
      oNetDrive.ShareName = "\\ComputerName\Share1"
      oNetDrive.MapDrive();
    • C#
      //Map drive with specified user credentials
      oNetDrive.LocalDrive = "m:";
      oNetDrive.ShareName = "\\ComputerName\Share1"
      oNetDrive.MapDrive("Bob_Username","Bob_Password");
    • C#
      //Map drive with and prompt user for credentials
      oNetDrive.LocalDrive = "m:";
      oNetDrive.ShareName = "\\ComputerName\Share1"
      oNetDrive.PromptForCredentials = true;
      oNetDrive.MapDrive();
    • C#
      //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

    • C#
      //Unmap a network connection
      oNetDrive.LocalDrive = "m:";
      oNetDrive.ShareName = "\\ComputerName\Share1"
      oNetDrive.UnMapDrive();
    • C#
      //Unmap a network connection ignoring network related errors
      oNetDrive.LocalDrive = "m:";
      oNetDrive.Force = true;
      oNetDrive.ShareName = "\\ComputerName\Share1"
      oNetDrive.UnMapDrive();
  • Other functions

    • C#
      //Display windows connection dialog
      oNetDrive.ShowConnectDialog(this);
      //Display windows disconnection dialog
      oNetDrive.ShowDisconnectDialog(this);
    • C#
      //Restore all persistent connections
      oNetDrive.RestoreDrives();

History

  • 14th May 2004 - build0015
    • LocalDrive and ShareName are now properties.
    • Dialog functions now use a form object instead of a window handle.
    • Renaming scheme for public functions and properties, MapNetworkDrive(...) is now MapDrive(...), 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, for MapDrive calls, if a drive is connected it will disconnect that drive then reconnect to the new share.
    • Added PromptForCredintals option, for MapDrive 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

License

This article, along with any associated source code and files, is licensed under The Creative Commons Attribution-ShareAlike 2.5 License


Written By
Web Developer
New Zealand New Zealand
C#, VB.net (Web and forms), SQL Server, MySQL, ASP, Win32 API, ...
Site: aejw.com

Comments and Discussions

 
GeneralRe: Using Windows Service Pin
NPayette17-May-06 9:42
NPayette17-May-06 9:42 
GeneralRe: Using Windows Service Pin
aejw18-May-06 0:28
aejw18-May-06 0:28 
GeneralRe: Using Windows Service Pin
alaiasRogue28-Aug-06 3:40
alaiasRogue28-Aug-06 3:40 
GeneralSame class with different OS Pin
lakhanisa21-Feb-06 21:23
lakhanisa21-Feb-06 21:23 
GeneralRe: Same class with different OS Pin
aejw15-May-06 18:36
aejw15-May-06 18:36 
GeneralRe: Same class with different OS [modified] Pin
cyberninja6624-Jan-07 21:26
cyberninja6624-Jan-07 21:26 
Generalgetting all the drive names Pin
oscar scott20-Feb-06 7:49
oscar scott20-Feb-06 7:49 
GeneralRe: getting all the drive names Pin
Slackshot29-Jun-06 4:31
Slackshot29-Jun-06 4:31 
I use WMI to get a list of shares from a given
machine. Although you can always use a wrapper
for Shell.Application if you don't have local admin.

You can also use WMI to get a list of drives.

"Select size,freespace from Win32_LogicalDisk where name = '" + DriveL + "'

When you do the share query you need to make sure you don't pull in Administrative shares.. Here is the WMI query for that..

"Select name,path from Win32_Share where type != '2147483648' and type != '2147483651'"

Please, keep in mind that if you use the Shell.Application method, that you do not have the ability to see any hidden or administrative shares. With WMI you can see them, if you need to.
QuestionHello is it allowed to be used? Pin
PGT25-Jan-06 4:04
PGT25-Jan-06 4:04 
AnswerRe: Hello is it allowed to be used? Pin
aejw15-May-06 18:27
aejw15-May-06 18:27 
Questionweb method can't implement? Pin
Arnecn12-Dec-05 22:25
Arnecn12-Dec-05 22:25 
QuestionJust using "Net Use"?? Pin
Nirosh5-Dec-05 4:46
professionalNirosh5-Dec-05 4:46 
AnswerRe: Just using "Net Use"?? Pin
aejw15-May-06 18:44
aejw15-May-06 18:44 
GeneralRe: Just using "Net Use"?? Pin
Nirosh29-Oct-06 23:32
professionalNirosh29-Oct-06 23:32 
Generalsimple solution for simpler requirements Pin
ren_reyes14-Nov-05 10:51
ren_reyes14-Nov-05 10:51 
GeneralRe: simple solution for simpler requirements Pin
dbarndt14-Mar-06 5:07
dbarndt14-Mar-06 5:07 
GeneralGreat article! Added getOpenDriveLetter. Pin
Member 354931016-Aug-05 3:03
Member 354931016-Aug-05 3:03 
GeneralRe: Great article! Added getOpenDriveLetter. Pin
aejw17-Aug-05 11:58
aejw17-Aug-05 11:58 
GeneralRe: Great article! Added getOpenDriveLetter. Pin
Anonymous19-Aug-05 11:05
Anonymous19-Aug-05 11:05 
GeneralRe: Great article! Added getOpenDriveLetter. Pin
Dewy6821-Aug-05 13:19
Dewy6821-Aug-05 13:19 
GeneralDisconnect bug Pin
jsantos9825-Jul-05 4:30
jsantos9825-Jul-05 4:30 
GeneralRe: Disconnect bug Pin
aejw25-Jul-05 7:18
aejw25-Jul-05 7:18 
GeneralRe: Disconnect bug Pin
Anonymous25-Jul-05 7:20
Anonymous25-Jul-05 7:20 
GeneralRe: Disconnect bug Pin
AlegreBonifacio14-Jul-06 1:17
AlegreBonifacio14-Jul-06 1:17 
GeneralRe: Disconnect bug Pin
AlegreBonifacio14-Jul-06 1:26
AlegreBonifacio14-Jul-06 1:26 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.