win.net 库模块帮助文档

说明

win.net 库函数加载 Mpr.dll(Multiple Provider Router) 到了 ::MprDll 对象，并封装了部分 Mpr.dll 提供的部份 WNet（ Windows networking ）前缀的 API 函数。

表录网络资源的 NETRESOURCE 结构体定义如下：

namespace win.net{
    class NETRESOURCE{
            INT scope;
            INT type;
            INT displayType;
            INT usage;
            ustring localName;
            ustring remoteName;
            ustring comment;
            ustring provider;
    }       
}

注意 aardio 里去掉了字段名里的类型前缀，例如原来的 dwDisplayType 精简为了 displayType。

win.net 所有需要输入 NETRESOURCE 结构体的参数都支持指定部分字段名，或仅用字符串指定 remoteName。

例如：var info,str = win.net.getInfo({remoteName="remoteName",scope=2})
或者：var info,str = win.net.getInfo("remoteName")

win.net 成员列表 #

WNet（ Windows networking ）函数库，例如网络共享文件与打印机资源接口。

win.net.addConnection(netResource,username,password,hwndOwner,flags) #

连接网络资源。
参数 @netResource 指定 NETRESOURCE 结构体或部分字段。
参数 @username 指定用户名。
参数 @password 指定密码
可选用参数 @hwndOwner 指定所有窗口句柄。
可选用参数 @flags 指定选项
详细用法请参考 API 函数 WNetAddConnection3 相关文档。

win.net.cancelConnection(name,flags,force) #

连接网络资源。
参数 @name 指定连接的资源名。
可选用参数 @flags 指定选项。
可选用参数 @force 指定如果连接上有打开的作业或文件是否断开，默认为 false 。
详细用法请参考 API 函数 WNetCancelConnection2W 相关文档。

win.net.enumResource(callback,resType,scope,usage) #

win.net.enumResource(  
    function(netResource,contrainer){  
        /*枚举网络资源，回调函数的返回 false （必须恒等于 false）则退出枚举。  
netResource 为包含当前网络资源信息的 NETRESOURCE 结构体。  
contrainer 为表示父容器的 NETRESOURCE 结构体，无父容器时 contrainer 为 null 。  
创建迭代器的 resType,scope,usage 参数请参考系统 API 函数 WNetOpenEnum 相关文档。  
注意在 aardio 中不指定 scope 则默认设为 2(_RESOURCE_GLOBALNET)*/  
    },1/*_RESOURCETYPE_DISK*/  
)

win.net.getInfo(netResource) #

获取信息。
参数 @1 可指定 NETRESOURCE 结构体或部分字段，也可仅传入指定 remoteName 的字符串。
第一个返回值为新的 NETRESOURCE 结构体，
第 2 个返回值为一个字符串，包含适用于特定系统函数的资源名称。

win.net.getUser(resName) #

返回连接指定资源的用户名。
参数 @resName 指定资源名称，如何传入 NETRESOURCE 结构体则取 remoteName 字段。
不指定参数则返回运行当前进程的用户名。

win.net.lasterr() #

返回 WNet 函数设置的错误信息与代码。
仅返回网络提供商报告的错误而非系统错误。
无错误则无返回值，否则返回：错误信息,网络提供程序名称,错误代码。

自动完成常量

_RESOURCEDISPLAYTYPE_DIRECTORY=9
_RESOURCEDISPLAYTYPE_DOMAIN=1
_RESOURCEDISPLAYTYPE_FILE=4
_RESOURCEDISPLAYTYPE_GENERIC=0
_RESOURCEDISPLAYTYPE_GROUP=5
_RESOURCEDISPLAYTYPE_NDSCONTAINER=0xB
_RESOURCEDISPLAYTYPE_NETWORK=6
_RESOURCEDISPLAYTYPE_ROOT=7
_RESOURCEDISPLAYTYPE_SERVER=2
_RESOURCEDISPLAYTYPE_SHARE=3
_RESOURCEDISPLAYTYPE_SHAREADMIN=8
_RESOURCEDISPLAYTYPE_TREE=0xA
_RESOURCETYPE_ANY=0
_RESOURCETYPE_DISK=1
_RESOURCETYPE_PRINT=2
_RESOURCETYPE_UNKNOWN=0xFFFF
_RESOURCEUSAGE_ALL=0
_RESOURCEUSAGE_CONNECTABLE=1
_RESOURCEUSAGE_CONTAINER=2
_RESOURCEUSAGE_RESERVED=0x80000000
_RESOURCE_CONNECTED=1
_RESOURCE_ENUM_ALL=0xFFFF
_RESOURCE_GLOBALNET=2
_RESOURCE_PUBLICNET=2
_RESOURCE_REMEMBERED=3

Markdown 格式