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

說(shuō)明

獲取網(wǎng)絡(luò)中一個(gè)文件的遠(yuǎn)程名稱以及/或者UNC（統(tǒng)一命名規(guī)范）名稱。例如，假設(shè)一個(gè)已連接的遠(yuǎn)程驅(qū)動(dòng)器是\\othersystem\CDrive，它對(duì)應(yīng)的本地驅(qū)動(dòng)器是F:，而且在它的子目錄temp中包含了文件xyz.doc。那么運(yùn)算結(jié)果如下：LocalPath xyz.doc 或 f:\temp\xyz.doc（或者文件的任何相對(duì)路徑名）

UNC 名稱： \\othersystem\CDrive\temp\xyz.doc

連接名稱： \\othersystem\CDrive

剩余名稱：  \temp\xyz.doc

它們分別對(duì)應(yīng)于由這個(gè)函數(shù)裝載的REMOTE_NAME_INFO結(jié)構(gòu)的字段，對(duì)該結(jié)構(gòu)的定義如下：

Type REMOTE_NAME_INFO

   pUniversalName As Long

   pConnectionName As Long

   pRemainingPath As Long

End Type

返回值

Long，零表示成功。會(huì)設(shè)置GetLastError。如GetLastError是ERROR_EXTENDED_ERROR，則可用WNetGetLastError取得額外的錯(cuò)誤信息

參數(shù)表

參數(shù)

類型及說(shuō)明

lpLocalPath

String，磁盤文件的名字

dwInfoLevel

Long，下述常數(shù)之一：

UNIVERSAL_NAME_INFO_LEVEL

只設(shè)置pUniversalName字段

REMOTE_NAME_INFO_LEVEL

設(shè)置REMOTE_NAME_INFO結(jié)構(gòu)中的所有三個(gè)字段

lpBuffer

Any，指定用于裝載UNC信息的一個(gè)緩沖區(qū)。緩沖區(qū)起點(diǎn)與一個(gè)REMOTE_NAME_INFO結(jié)構(gòu)對(duì)應(yīng)

lpBufferSize

Long，以字節(jié)為單位指定lpBuffer緩沖區(qū)的長(zhǎng)度。如緩沖區(qū)不夠大，則設(shè)為需要的緩沖區(qū)長(zhǎng)度

Top