共享访问在.NET中的编程实现

共享访问在.NET中的编程实现
 
发布日期:2007-08-08 | 更新日期:2009-03-15
作者:郑佐

摘要: 本文简单介绍在.NET中如何 通过API实现局域网共享访问编程
 
本页内容
 
概述
一般用户在访问局域网中的计算机时都需要提供访问凭据,如果想通过编程来实现自动登录,.NET开发人员一般首先会想到通过调用WMI来实现。但是在实现过程中也许你会发现使用ConnectionOptions类不是很理想,因此本文采用了平台调用的方式来介绍共享访问编程实现。
 
API 介绍
mpr.dll 是Windws操作系统网络通讯相关模块,通过对功能需求的分析,直接调用mpr.dll来实现该功能。在.NET中需要通过平台调用(platform invoke)来调用其中的方法,这里需要用到mpr.dll中的两个方法。对于mpr.dll中包含的具体功能这里不进行阐述,大家通过MSDN可以找到详细说明,这里只列出方法定义。
DWORD WNetAddConnection2(
  LPNETRESOURCE lpNetResource,
  LPCTSTR lpPassword,
  LPCTSTR lpUsername,
  DWORD dwFlags
);
 
该方法主要功能是添加远程网络连接。
参数描述如下:
lpNetResource :是一个包含网络访问资源的结构,在这里作为参数用来指定详细的网络连接信息,具体请看下面。
lpPassword :指出访问远程计算机的密码。在Windows 95/98/Me 系统中,该值必须设置为NULL或空字符串。
lpUsername :指出访问远程计算机的用户名。在Windows 95/98/Me 系统中,该值必须设置为NULL或空字符串。
dwFlags :指出连接选项,包含六种设置,具体可以看MSDN。
 
方法返回值:如果方法执行成功返回“NO_ERROR”即“0”。如果执行失败返回 System Error Code
 
NETRESOURCE 结构通过多个字段指定网络连接资源信息。定义如下:
typedef struct _NETRESOURCE {
  DWORD dwScope;
  DWORD dwType;
  DWORD dwDisplayType;
  DWORD dwUsage;
  LPTSTR lpLocalName;
  LPTSTR lpRemoteName;
  LPTSTR lpComment;
  LPTSTR lpProvider;
} NETRESOURCE;
 
各个成员描述如下:
dwScope :指定枚举范围。设置RESOURCE_CONNECTED,RESOURCE_GLOBALNET,RESOURCE_REMEMBERED三值之一。
dwType :指定访问的资源类型。设置三个值之一。RESOURCETYPE_ANY表示所有资源;RESOURCETYPE_DISK表示磁盘资源;RESOURCETYPE_PRINT表示打印机。
dwDisplayType :指出资源显示类型。RESOURCEDISPLAYTYPE_DOMAIN;RESOURCEDISPLAYTYPE_SERVER;RESOURCEDISPLAYTYPE_SHARE;RESOURCEDISPLAYTYPE_GENERIC。
dwUsage :描述资源的使用方式。设置RESOURCEUSAGE_CONNECTABLE 或RESOURCEUSAGE_CONTAINER。
lpLocalName :同dwScope关联,指定本地映射。
lpRemoteName :远程访问文件夹路径。
lpComment :描述。
lpProvider :资源提供者,可以设置为NULL。
 
DWORD WNetCancelConnection2(
  LPCTSTR lpName,
  DWORD dwFlags,
  BOOL fForce
);
 
通过该方法实现释放存在的网络连接。
各成员描述如下:
lpName :指定本地驱动器或远程共享资源
dwFlags :表示断开连接方式。设置 0 或CONNECT_UPDATE_PROFILE。
fForce :如果当前正在使用远程资源,是否进行强制断开连接。如果设置FALSE,在有远程资源使用的情况下关闭连接操作将会失败。
 
方法返回值:如果方法执行成功返回“NO_ERROR”即“0”。如果执行失败返回 System Error Code
 
针对以上两个方法,有些System Error Code返回值并不意味远程资源不可以访问。
例如:
ERROR_SESSION_CREDENTIAL_CONFLICT
1219
Multiple connections to a server or shared resource by the same user, using more than one user name, are not allowed. Disconnect all previous connections to the server or shared resource and try again.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED
1220
An attempt was made to establish a session to a network server, but there are already too many sessions established to that server.
 
代码实现
为便于在.NET环境中使用,本文写了一个WNetConnectionHelper静态类,对这些方法进行包装。
P/Invoke 需要引用 System.Runtime.InteropServices 命名空间。 由于代码简短,下面给出完整实现代码。
public  static class WNetConnectionHelper
{
    [DllImport("mpr.dll", EntryPoint = "WNetAddConnection2")]
    private static extern uint WNetAddConnection2(NetResource lpNetResource, string lpPassword, string lpUsername, uint dwFlags);
 
    [DllImport("Mpr.dll", EntryPoint = "WNetCancelConnection2"))]
    private static extern uint WNetCancelConnection2(string lpName, uint dwFlags, bool fForce);
 
    [StructLayout(LayoutKind.Sequential)]
    public class NetResource
    {
        public int dwScope;
        public int dwType;
        public int dwDisplayType;
        public int dwUsage;
        public string lpLocalName;
        public string lpRemoteName;
        public string lpComment;
        public string lpProvider;
    }
 
    public static uint WNetAddConnection(NetResource netResource,string username,string password)
    {
        uint result = WNetAddConnection2(netResource, password, username, 0);
        return result;
    }
 
    public static uint WNetAddConnection(string username, string password, string remoteName, string localName)
    {
        NetResource netResource = new NetResource();
        netResource.dwScope = 2;       //RESOURCE_GLOBALNET
        netResource.dwType = 1;       //RESOURCETYPE_ANY
        netResource.dwDisplayType = 3; //RESOURCEDISPLAYTYPE_GENERIC
        netResource.dwUsage = 1;       //RESOURCEUSAGE_CONNECTABLE
        netResource.lpLocalName = localName;
        netResource.lpRemoteName = remoteName.TrimEnd('//');
        //netResource.lpRemoteName = lpComment;
        //netResource.lpProvider = null;
        uint result = WNetAddConnection2(netResource, password, username, 0);
        return result;
    }
 
    public static uint WNetCancelConnection(string name,uint flags,bool force)
    {
        uint nret = WNetCancelConnection2(name, flags, force);
        return nret;
    }
}
 
应用示例
最后,通过两个简单示例来演示 WNetConnectionHelper 类的使用
a .列举远程计算机共享文件夹资源。代码如下:
try
{
    string  result = WNetConnectionHelper.WNetAddConnection("192.120.40.10//ShareUser", "xxxxxx", @"//192.120.40.10/test", null);
    string  [] files = Directory.GetFiles(@"//192.120.40.56/test/fw");
    string  s1 = GetFile(@"//192.120.40.10/test/fw/test.doc");
    uint  n =   WNetConnectionHelper.WNetCancelConnection("//192.120.40.10//test", 1, true);
}
catch  (Exception ex)
{
    // 编写异常处理代码
}
 
 
b. 另一个比较常见的应用是在ASP.NET服务器端访问其他计算机的资源,比如文档服务器,然后通过Web页面输出。
主要示例代码如下:
protected  void Page_Load(object sender, EventArgs e)
{
    uint r = WNetConnectionHelper.WNetAddConnection("192.120.40.10//username", "password", @"//192.120.40.10/test", "Z:");
    string filename = @"//192.120.40.10/test/fw/1.doc";
    ReadFile(filename);
}
 
写文件到Web输出:
public  void ReadFile(string filename)
{
    Response.Clear();
    Response.Charset = "utf-8";
    Response.Buffer = true;
    this.EnableViewState = false;
    Response.ContentType = "application/ms-word";
    Response.ContentEncoding = System.Text.Encoding.UTF8;
    Response.AppendHeader("Content-Disposition", "inline;filename=1.doc");
    try
    {
         Response.WriteFile(filename, true);
    }
    catch (Exception ex)
    {
        Response.Write(ex.ToString());
    }
    Response.Flush();
}
以上方法对于大文件使用Response.WriteFile方法会有些问题,在实际编程中需要做优化处理。
 
结束语
本文中的有些功能描述可能不够具体或妥当,如果需要了解mpr.dll的更多功能还是建议看MSDN文档。对于WNetConnectionHelper的实现存在一些需要完善的地方,不过对于一般的应用基本可以满足,在实际使用时还需要考虑多线程的情况。另外,在有同名驱动器映射的情况下需要做一些判断,而且弄清楚System Error Code的含义对代码的调试及正确执行有很大的帮助。This is some   sample text. You are using FCKeditor.

评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值