WNetGetUniversalName

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（统一命名规范）名称。例如，假设一个已连接的远程驱动器是\othersystemCDrive，它对应的本地驱动器是F:，而且在它的子目录temp中包含了文件xyz.doc。那么运算结果如下：LocalPath xyz.doc 或 f:empxyz.doc（或者文件的任何相对路径名）

UNC 名称： \othersystemCDriveempxyz.doc

连接名称： \othersystemCDrive

剩余名称： empxyz.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_INFO结构对应

lpBufferSize Long，以字节为单位指定lpBuffer缓冲区的长度。如缓冲区不够大，则设为需要的缓冲区长度