WNetGetUniversalName

基本介紹

• 中文名：WNetGetUniversalName
• lpLocalPath String：磁碟檔案的名字
• 連線名稱： \\othersystem\CDrive
• 剩餘名稱：\temp\xyz.doc

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:\temp\xyz.doc（或者檔案的任何相對路徑名）

VB語言程式設計

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_INFO結構對應

lpBufferSize Long，以位元組為單位指定lpBuffer緩衝區的長度。如緩衝區不夠大，則設為需要的緩衝區長度