Map Network Drive (API)

• Download source code / example - 34 Kb

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

     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 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

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