GetFullPathName是計算機函式。
基本介紹
- 外文名：GetFullPathName
- 說明：獲取指定檔案的完整路徑名
- Long：裝載到lpBuffer中的字元數量
- 功能說明：從一指定檔案得到檔案的路徑
VB聲明,VC聲明,
VB聲明
Declare Function GetFullPathName& Lib "kernel32" Alias "GetFullPathNameA" (ByVal lpFileName As String, ByVal nBufferLength As Long, ByVal lpBuffer As String, lpFilePart As Long)
說明
獲取指定檔案的完整路徑名
返回值
Long，裝載到lpBuffer中的字元數量（排除空中止字元）。如緩衝區的長度不足以容下完整的路徑，則返回值就是要求的緩衝區大小。零表示失敗。會設定GetLastError
參數表
參數 類型及說明
lpFileName String，指定檔案名稱（長檔案名稱或8.3格式的DOS檔案名稱）
nBufferLength Long，lpBuffer字串的長度
lpBuffer String，指定一個預先定義好的字串，用於裝載目標檔案的驅動器及路徑名稱。如存在長檔案名稱，那么這個參數保存的就肯定是長檔案名稱
lpFilePart Long，指定一個長整數變數，用於裝載檔案名稱起始的地方。參考註解
註解
lpFilePart參數在vb里很難使用。它的問題在於：儘管windows在這個Long值中裝載lpBuffer字串中的地址，用它表示路徑信息檔案名稱部分的起始處。但非常不幸，由vb創建的、傳遞給api的ANSI字串緩衝區也會使用這個地址。等這個函式返回的時候，vb已將返回的（lpBuffer）字串複製回它的內部Unicode字串緩衝區，所以lpFilePart地址已沒有任何意義。因此，我們面臨兩種選擇。首先，可以簡單的不使用lpFilePart信息（忽略windows裝載在參數中的值）。其次，可以將lpBuffer參數變成一個位元組數組（lpFilePart As Byte——將數組的第一個元素作為參數傳遞）
其他
在vb的api文本查看器中複製的聲明為：Declare Function GetFullPathName Lib "kernel32" Alias "GetFullPathNameA" (ByVal lpFileName As String,ByVal nBufferLength As Long, ByVal lpBuffer As String, ByVal lpFilePart As String) As Long
VC聲明
DWORD GetFullPathName(
LPCTSTR lpFileName, // file name
DWORD nBufferLength, // size of path buffer,建議取值為:MAX_PATH
LPTSTR lpBuffer, // path buffer
LPTSTR *lpFilePart // address of file name in path
);
功能說明
從一指定檔案得到檔案的路徑
參數說明
LPCTSTR lpFileName, 指定檔案的名字
DWORD nBufferLength,快取區的大小
LPTSTR lpBuffer, 用於存放路徑的快取區
LPTSTR *lpFilePart 檔案名稱的起始地址
返回值
如果調用成功 返回實際路徑的長度
如果緩衝區太小,不能裝下檔案完整路徑的話 返回值就是緩衝區的值 所以我們一般都將快取區大小設定得足夠大
調用失敗 返回0 用GetLastError獲得錯誤信息
