精华区文章阅读

发信人: bloom (小石头长大了), 信区: VB
标  题: 网络函数
发信站: 哈工大紫丁香 (2000年07月23日17:28:59 星期天), 转信

    目录
WNetAddConnection 创建同一个网络资源的永久性连接
WNetAddConnection2 创建同一个网络资源的连接
WNetAddConnection3 创建同一个网络资源的连接
WNetCancelConnection 结束一个网络连接
WNetCancelConnection2 结束一个网络连接
WNetCloseEnum 结束一次枚举操作
WNetConnectionDialog 启动一个标准对话框，以便建立同网络资源的连接
WNetDisconnectDialog 启动一个标准对话框，以便断开同网络资源的连接
WNetEnumResource 枚举网络资源
WNetGetConnection 获取本地或已连接的一个资源的网络名称
WNetGetLastError 获取网络错误的扩展错误信息
WNetGetUniversalName 获取网络中一个文件的远程名称以及/或者UNC（统一命名规范）
名称
WNetGetUser 获取一个网络资源用以连接的名字
WNetOpenEnum 启动对网络资源进行枚举的过程
____________________________________________________
WNetAddConnection
VB声明
Declare Function WNetAddConnection Lib "mpr.dll" Alias "WNetAddConnectionA"
(ByVal lpszNetPath As String, ByVal lpszPassword As String, ByVal lpszLocalN
ame As String) As Long
说明
创建同一个网络资源的永久性连接
返回值
Long，零表示成功。会设置GetLastError。如GetLastError是ERROR_EXTENDED_ERROR，
则可用WNetGetLastError取得额外的错误信息
参数表
参数类型及说明
lpszNetPath String，要连接的网络名
lpszPassword String，可选的一个密码。如为vbNullString，表示采用当前用户的默认
密码。如为一个空字串，则不用任何密码
lpszLocalName String，资源的本地名称。（例如，F: 和 LPT1:）
________________________________________________
WNetAddConnection2
VB声明
Declare Function WNetAddConnection2 Lib "mpr.dll" Alias "WNetAddConnection2A
" (lpNetResource As NETRESOURCE, ByVal lpPassword As String, ByVal lpUserNam
e As String, ByVal dwFlags As Long) As Long
说明
创建同一个网络资源的连接
返回值
Long，零表示成功。会设置GetLastError。如GetLastError是ERROR_EXTENDED_ERROR，
则可用WNetGetLastError取得额外的错误信息
参数表
参数类型及说明
lpNetResource NETRESOURCE，在这个结构中设置了下述字段，对要连接的网络资源进行
了定义：dwType， lpLocalName （可为 vbNullString）， lpRemoteName， lpProvid
er （设为 vbNullString 表示用默认提供者）。该结构的其他所有变量都会被忽略
lpPassword String，可选的一个密码。如为vbNullString，表示采用当前用户的默认密
码。如为一个空字串，则不用任何密码
lpUserName String，用于连接的用户名。如为vbNullString，表示使用当前用户
dwFlags Long，设为零；或指定常数CONNECT_UPDATE_PROFILE，表示创建永久性连接
___________________________________________________________________________
WNetAddConnection3
VB声明
Declare Function WNetAddConnection3& Lib "mpr.dll" Alias "WNetAddConnection3
A" (ByVal hwnd As Long, lpNetResource As NETRESOURCE, ByVal lpPassword As St
ring, ByVal lpUserName As String, ByVal dwFlags As Long)
说明
创建同一个网络资源的连接。这个函数与WNetAddConnection2类似，只是它允许我们为
这个函数显示的对话框指定一个物主窗口
返回值
Long，
参数表
参数类型及说明
hwnd Long，指定一个窗口句柄，用作本函数创建的对话框的父窗口
lpNetResource NETRESOURCE，在这个结构中设置了下述字段，对要连接的网络资源进行
了定义：dwType， lpLocalName （可为 vbNullString）， lpRemoteName， lpProvid
er （设为 vbNullString 表示用默认提供者）。该结构的其他所有变量都会被忽略
lpPassword String，可选的一个密码。如为vbNullString，表示采用当前用户的默认密
码。如为一个空字串，则不用任何密码
lpUserName String，用于连接的用户名。如为vbNullString，表示使用当前用户
dwFlags Long，设为零；或指定常数CONNECT_UPDATE_PROFILE，表示创建永久性连接
_______________________________________________________
WNetCancelConnection
VB声明
Declare Function WNetCancelConnection Lib "mpr.dll" Alias "WNetCancelConnect
ionA" (ByVal lpszName As String, ByVal bForce As Long) As Long
说明
结束一个网络连接
返回值
Long，零表示成功。会设置GetLastError。如GetLastError是ERROR_EXTENDED_ERROR，
则可用WNetGetLastError取得额外的错误信息
参数表
参数类型及说明
lpszName String，已连接资源的远程名称或本地名称
bForce Long，如为TRUE，表示断开连接（即使连接的资源上正有打开的文件或作业）
___________________________________________________________________
WNetCancelConnection2
VB声明
Declare Function WNetCancelConnection2 Lib "mpr.dll" Alias "WNetCancelConnec
tion2A" (ByVal lpName As String, ByVal dwFlags As Long, ByVal fForce As Long
) As Long
说明
结束一个网络连接
返回值
Long，零表示成功。会设置GetLastError。如GetLastError是ERROR_EXTENDED_ERROR，
则可用WNetGetLastError取得额外的错误信息
参数表
参数类型及说明
lpszName String，已连接资源的远程名称或本地名称
dwFlags Long，设为零或CONNECT_UPDATE_PROFILE。如为零，而且建立的是永久性连接
，则在windows下次重新启动时仍会重新连接
fForce Long，如为TRUE，表示强制断开连接（即使连接的资源上正有打开的文件或作业
）
_________________________________________________________________________
WNetCloseEnum
VB声明
Declare Function WNetCloseEnum Lib "mpr.dll" Alias "WNetCloseEnum" (ByVal hE
num As Long) As Long
说明
结束一次枚举操作
返回值
Long，零表示成功。会设置GetLastError。如GetLastError是ERROR_EXTENDED_ERROR，
则可用WNetGetLastError取得额外的错误信息
参数表
参数类型及说明
hEnum Long，由 WNetOpenEnum函数返回的一个枚举句柄
_____________________________________________________________________
WNetConnectionDialog
VB声明
Declare Function WNetConnectionDialog Lib "mpr.dll" Alias "WNetConnectionDia
log" (ByVal hwnd As Long, ByVal dwType As Long) As Long
说明
启动一个标准对话框，以便建立同网络资源的连接
返回值
Long，零表示成功。如用户取消了操作，则返回-1。会设置GetLastError。如GetLastE
rror是ERROR_EXTENDED_ERROR，则可用WNetGetLastError取得额外的错误信息
参数表
参数类型及说明
hwnd Long，指定要成为对话框父窗口的一个窗口的句柄
dwType Long，设成RESOURCETYPE_DISK，浏览磁盘资源
____________________________________________________________________________
WNetDisconnectDialog
VB声明
Declare Function WNetDisconnectDialog Lib "mpr.dll" Alias "WNetDisconnectDia
log" (ByVal hwnd As Long, ByVal dwType As Long) As Long
说明
启动一个标准对话框，以便断开同网络资源的连接
返回值
Long，零表示成功。如用户取消了操作，则返回-1。会设置GetLastError。如GetLastE
rror是ERROR_EXTENDED_ERROR，则可用WNetGetLastError取得额外的错误信息
参数表
参数类型及说明
hwnd Long，指定要成为对话框父窗口的一个窗口的句柄
dwType Long，设成RESOURCETYPE_DISK 或 RESOURCETYPE_PRINT，决定要断开的是磁盘
还是打印机资源
___________________________________________________________
WNetEnumResource
VB声明
Declare Function WNetEnumResource Lib "mpr.dll" Alias "WNetEnumResourceA" (B
yVal hEnum As Long, lpcCount As Long, lpBuffer As Any, lpBufferSize As Long)
As Long
说明
枚举网络资源
返回值
Long，零表示成功。ERROR_NO_MORE_ITEMS表示不剩下可以枚举的条目。ERROR_MORE_DA
TA表示条目不能装入lpBuffer。会设置GetLastError。如GetLastError是ERROR_EXTEND
ED_ERROR，则可用WNetGetLastError取得额外的错误信息
参数表
参数类型及说明
hEnum Long，从WNetOpenEnum函数返回的一个句柄
lpcCount Long，最初设为要枚举的最大资源数量；或设为-1，表示枚举尽可能多的资源
。一旦返回，就会设为实际枚举的资源数量
lpBuffer Any，通常是一个字节缓冲区的首字节。该缓冲区装载了枚举信息（可按引用
声明为Byte）
lpBufferSize Long，以字节为单位指定lpBuffer数组的长度。如缓冲区不够大，则设为
需要的缓冲区长度
注解
枚举网络条目时，最好用vb一次枚举一个资源。尽量不要使用这个函数同时枚举许多网
络资源的功能
__________________________________________________________________________
WNetGetConnection
VB声明
Declare Function WNetGetConnection Lib "mpr.dll" Alias "WNetGetConnectionA"
(ByVal lpszLocalName As String, ByVal lpszRemoteName As String, cbRemoteName
As Long) As Long
说明
获取本地或已连接的一个资源的网络名称
返回值
Long，零表示成功。会设置GetLastError。如GetLastError是ERROR_EXTENDED_ERROR，
则可用WNetGetLastError取得额外的错误信息
参数表
参数类型及说明
lpszLocalName String，本地设备的名字
lpszRemoteName String，指定一个字串缓冲区，用于装载设备的资源名称
cbRemoteName Long，lpszRemoteName缓冲区的字符数量。如缓冲区不够大，则设为需要
的缓冲区长度
_______________________________________________________
WNetGetLastError
VB声明
Declare Function WNetGetLastError Lib "mpr.dll" Alias "WNetGetLastErrorA" (l
pError As Long, ByVal lpErrorBuf As String, ByVal nErrorBufSize As Long, ByV
al lpNameBuf As String, ByVal nNameBufSize As Long) As Long
说明
获取网络错误的扩展错误信息
返回值
Long，零表示成功。ERROR_INVALID_ADDRESS表示缓冲区无效
参数表
参数类型及说明
lpError Long，指定一个变量，用于装载网络错误代码。具体的代码由网络供应商决定

lpErrorBuf String，指定一个字串缓冲区，用于装载网络错误的说明
nErrorBufSize Long，lpErrorBuf缓冲区包含的字符数量
lpNameBuf String，用于装载网络供应商名字的字串缓冲区
nNameBufSize Long，lpNameBuf缓冲区的字符数量
_________________________________________________
WNetGetUniversalName
VB声明
Declare Function WNetGetUniversalName Lib "mpr" Alias "WNetGetUniversalNameA
" (ByVal lpLocalPath As String, ByVal dwInfoLevel As Long, lpBuffer As Any,
lpBufferSize As Long) As Long
说明
获取网络中一个文件的远程名称以及/或者UNC（统一命名规范）名称。例如，假设一个
已连接的远程驱动器是\\othersystem\CDrive，它对应的本地驱动器是F:，而且在它的
子目录temp中包含了文件xyz.doc。那么运算结果如下：LocalPath xyz.doc 或 f:\tem
p\xyz.doc（或者文件的任何相对路径名）
UNC 名称： \\othersystem\CDrive\temp\xyz.doc
连接名称： \\othersystem\CDrive
剩余名称：  \temp\xyz.doc
它们分别对应于由这个函数装载的REMOTE_NAME_INFO结构的字段，对该结构的定义如下
：
Type REMOTE_NAME_INFO
    pUniversalName As Long
    pConnectionName As Long
    pRemainingPath As Long
End Type
返回值
Long，零表示成功。会设置GetLastError。如GetLastError是ERROR_EXTENDED_ERROR，
则可用WNetGetLastError取得额外的错误信息
参数表
参数类型及说明
lpLocalPath String，磁盘文件的名字
dwInfoLevel Long，下述常数之一：
UNIVERSAL_NAME_INFO_LEVEL 只设置pUniversalName字段
REMOTE_NAME_INFO_LEVEL 设置REMOTE_NAME_INFO结构中的所有三个字段
lpBuffer Any，指定用于装载UNC信息的一个缓冲区。缓冲区起点与一个REMOTE_NAME_I
NFO结构对应
lpBufferSize Long，以字节为单位指定lpBuffer缓冲区的长度。如缓冲区不够大，则设
为需要的缓冲区长度
_____________________________________________________
WNetGetUser
VB声明
Declare Function WNetGetUser Lib "mpr.dll" Alias "WNetGetUserA" (ByVal lpNam
e As String, ByVal lpUserName As String, lpnLength As Long) As Long
说明
获取一个网络资源用以连接的名字
返回值
Long，零表示成功。会设置GetLastError。如GetLastError是ERROR_EXTENDED_ERROR，
则可用WNetGetLastError取得额外的错误信息
参数表
参数类型及说明
lpName String，指定已连接资源的远程名称或本地名称。用vbNullString获取当前用户
的名字
lpUserName String，用于装载用户名的一个字串缓冲区
lpnLength Long，lpUserName缓冲区的长度。如缓冲区不够大，则自动设为需要的缓冲
区长度
_______________________________________
WNetOpenEnum
VB声明
Declare Function WNetOpenEnum Lib "mpr.dll" Alias "WNetOpenEnumA" (ByVal dwS
cope As Long, ByVal dwType As Long, ByVal dwUsage As Long, lpNetResource As
NETRESOURCE, lphEnum As Long) As Long
说明
启动对网络资源进行枚举的过程。这个函数会返回由WNetEnumResource函数用于枚举资
源所用的一个句柄
返回值
Long，零表示成功。会设置GetLastError。如GetLastError是ERROR_EXTENDED_ERROR，
则可用WNetGetLastError取得额外的错误信息
参数表
参数类型及说明
dwScope Long，指定要枚举的资源范围。可设为下述常数之一：
RESOURCE_CONNECTED 枚举已连接的资源（忽略dwUsage）
RESOURCE_GLOBALNET 枚举所有资源
RESOURCE_REMEMBERED 只枚举永久性连接
dwType Long，下述常数之一
RESOURCE_ANY 枚举所有类型的网络资源
RESOURCE_DISK 枚举磁盘资源
RESOURCE_PRINT 枚举打印资源
dwUsage Long，可设为零，表示枚举所有资源；或设为下述常数的一个或两个：
RESOURCEUSAGE_CONNECTABLE 只枚举那些能够连接的资源
RESOURCEUSAGE_CONTAINER 只枚举包含了其他资源的资源
lpNetResource NETRESOURCE，这个结构指定了一个容器资源。该函数会枚举包含于这里
指定的某个指定资源内的资源。如设为NULL（把声明变成ByVal As Long），那么函数会
枚举顶级网络资源。倘若在dwScope参数里没有指定RESOURCE_GLOBALNET，那么必须为N
ULL
lphEnum Long，指定一个变量，用于装载一个枚举句柄。该句柄由WNetEnumResource函
数使用。必须用WNetCloseEnum函数将其清除

     又臭，又硬。
           小石头

※ 来源:·哈工大紫丁香 bbs.hit.edu.cn·[FROM: 202.118.233.140]

VB 版 (精华区)