使用PB調(diào)用API自動(dòng)更新（非FTP模式）（二、API說(shuō)明及定義（1））
2024-07-21 02:10:16
供稿：網(wǎng)友
一、wnetaddconnection2a
function ulong wnetaddconnection2a(ref s_netresource lpnetresource, string lppassword, string lpusername, long dwflags) library "mpr.dll" alias for "wnetaddconnection2a"
說(shuō)明：
vb聲明
declare function wnetaddconnection2 lib "mpr.dll" alias "wnetaddconnection2a" (lpnetresource as netresource, byval lppassword as string, byval lpusername as string, byval dwflags as long) as long
說(shuō)明
創(chuàng)建同一個(gè)網(wǎng)絡(luò)資源的連接
返回值
long，零表示成功。>0表示失敗
參數(shù)表
參數(shù) 類型及說(shuō)明
lpnetresource 在這個(gè)結(jié)構(gòu)中設(shè)置了下述字段，對(duì)要連接的網(wǎng)絡(luò)資源進(jìn)行了定義：dwtype， lplocalname （可為 vbnullstring）， lpremotename， lpprovider （設(shè)為 vbnullstring 表示用默認(rèn)提供者）。該結(jié)構(gòu)的其他所有變量都會(huì)被忽略
lppassword string，可選的一個(gè)密碼。如為vbnullstring，表示采用當(dāng)前用戶的默認(rèn)密碼。如為一個(gè)空字串，則不用任何密碼
lpusername string，用于連接的用戶名。如為vbnullstring，表示使用當(dāng)前用戶
dwflags long，設(shè)為零；或指定常數(shù)connect_update_profile，表示創(chuàng)建永久性連接
2、wnetgetconnectiona
function ulong wnetgetconnectiona(string lpszlocalname, string lpszremotename, long cbremotename) library "mpr.dll"
說(shuō)明：
vb聲明
declare function wnetgetconnection lib "mpr.dll" alias "wnetgetconnectiona" (byval lpszlocalname as string, byval lpszremotename as string, cbremotename as long) as long
說(shuō)明
獲取本地或已連接的一個(gè)資源的網(wǎng)絡(luò)名稱
返回值
long，零表示成功。>0表示失敗。
參數(shù)表
參數(shù) 類型及說(shuō)明
lpszlocalname string，本地設(shè)備的名字
lpszremotename string，指定一個(gè)字串緩沖區(qū)，用于裝載設(shè)備的資源名稱
cbremotename long，lpszremotename緩沖區(qū)的字符數(shù)量。如緩沖區(qū)不夠大，則設(shè)為需要的緩沖區(qū)長(zhǎng)度
3、findfirstfilea
function ulong findfirstfilea(string lpfilename, ref s_win32_find_data lpfindfiledata) library "kernel32.dll"
vb聲明
declare function findfirstfile lib "kernel32" alias "findfirstfilea" (byval lpfilename as string, lpfindfiledata as win32_find_data) as long
說(shuō)明
根據(jù)文件名查找文件
返回值
long，如執(zhí)行成功，返回一個(gè)搜索句柄。如果出錯(cuò)，返回一個(gè)invalid_handle_value常數(shù)，一旦不再需要，應(yīng)該用findclose函數(shù)關(guān)閉這個(gè)句柄
參數(shù)表
參數(shù) 類型及說(shuō)明
lpfilename string，欲搜索的文件名。可包含通配符，并可包含一個(gè)路徑或相對(duì)路徑名
lpfindfiledata win32_find_data，這個(gè)結(jié)構(gòu)用于裝載與找到的文件有關(guān)的信息。該結(jié)構(gòu)可用于后續(xù)的搜索
注解
由這個(gè)函數(shù)返回的句柄可以作為一個(gè)參數(shù)用于findnextfile函數(shù)。這樣一來(lái)，就可以方便的枚舉出與lpfilename參數(shù)指定的文件名相符的所有文件
4、findclose
function ulong findclose(ulong hfindfile) library "kernel32.dll"
vb聲明
declare function findclose lib "kernel32" alias "findclose" (byval hfindfile as long) as long
說(shuō)明
關(guān)閉由findfirstfile函數(shù)創(chuàng)建的一個(gè)搜索句柄
返回值
long，非零表示成功，零表示失敗。會(huì)設(shè)置getlasterror
參數(shù)表
參數(shù) 類型及說(shuō)明
hfindfile long，由findfirstfile函數(shù)提供的搜索句柄
