win.net 库模块帮助文档

说明

win.net 并封装了部分 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")

添加映射网络驱动器（ WebDAV 服务端）示例：

import win.net;
var netres = win.net.addConnection(,"http://localhost:8081","username","password")
print(  netres[["localName"]] || win.net.lasterr() );

win.net 成员列表 #

WNet（ Windows networking ）函数库，例如网络共享文件与打印机资源接口。
s相关标准库: web.dav.server, web.dav.client, web.dav.sys

win.net.addConnection #

添加网络资源连接。
成功返回 NETRESOURCE 结构体，失败返回 null,错误信息,错误代码。

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

添加映射网络驱动器。

参数 @localName 指定本地映射分区名（字符串值，示例：Z:）。
如果 @localName 为空值（保持参数占位或传 null 值）则自动分配空闲分区号。
参数 @remoteName 指定网络资源路径（字符串值）。
@remoteName 指定 HTTP/HTTPS 协议的 WebDAV URL 时会自动转为 UNC 格式。
参数 @username 指定用户名（字符串值）。
参数 @password 指定密码（字符串值）。
可选用参数 @hwndOwner 指定所有窗口句柄。
可选用参数 @flags 指定选项。
详细用法请参考 API 函数 WNetAddConnection3 相关文档。

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

添加网络资源连接。
参数 @netResource 指定 NETRESOURCE 结构体或指定了部分结构体字段的表对象。
参数 @username 指定用户名。
参数 @password 指定密码
可选用参数 @hwndOwner 指定所有窗口句柄。
可选用参数 @flags 指定选项。
@flags 为 8/*_CONNECT_INTERACTIVE*/ 则允许输入并确认登录用户名与密码。
其他用法请参考 API 函数 WNetAddConnection3 相关文档。

win.net.cancelConnection #

断开网络连接资源（映射网络驱动器），成功返回 true。

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

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

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

参数 @remoteName 指定连接的网络资源名。
可选用参数 @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 #

返回连接指定资源的用户名。

win.net.getUser() #

不指定参数则返回运行当前进程的用户名。

win.net.getUser(netResource) #

参数 @netResource 指定 NETRESOURCE 结构体。

win.net.getUser(remoteName) #

参数 @remoteName 指定网络资源名称。
不指定参数则返回运行当前进程的用户名。

win.net.lasterr() #

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

win.net.urlToUnc(remoteName) #

参数 @remoteName 为 URL 时转换为 UNC 返回。
其他参数直接返回（只能为字符串或 null 值）。

自动完成常量

_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 格式