在PowerBuilder與DLL之間傳遞參數(shù)的方法

? ? 許多熟練使用C的程序員在使用PowerBuilder時都希望自己以前在C上做的工作可以被PowerBuilder所引用,這是完全可以的。在PowerBuilder中你可以通過外部引用函數(shù)的形式來調(diào)用動態(tài)連接庫(DLL)中的函數(shù)。筆者在此闡述PowerBuilder調(diào)用DLL時的參數(shù)傳遞方法。

??? 一般情況下,在PowerBuilder的script調(diào)用DLL中的函數(shù)都要傳遞參數(shù),以便DLL中的函數(shù)知道應(yīng)該作什么。DLL中的函數(shù)可以有返回值或通過修改參數(shù)來返回結(jié)果。缺省情況下
,PowerBuilder通過傳值法來傳遞參數(shù)(passed by value)。這意味著PowerBuilder將對傳遞的參數(shù)做一份拷貝,然后通過堆棧將這份拷貝傳遞給函數(shù)。因此函數(shù)中所有對參數(shù)的修改
都不會影響作為參數(shù)的變量的原值。使用傳值法調(diào)用的函數(shù)可以通過返回值來報告執(zhí)行結(jié)果。如果你希望DLL中的函數(shù)可以改變調(diào)用參數(shù)的原值,就可以通過參考傳值法(passed reference)來傳遞參數(shù),其說明方法如下:
Function int PassArgument(REF int refarg) LIBRARY"mydll.dll"
通過在參數(shù)類型前面加REF關(guān)鍵字來聲明該參數(shù)將要用參考傳值法傳遞。這意味著,PowerBuilder不在堆棧中做參數(shù)拷貝,而是將指向參數(shù)的指針壓入堆棧傳遞給DLL中的函數(shù)。讓我們詳細(xì)看一下這兩種參數(shù)傳遞方法的區(qū)別(本文使用的C代碼是用Visual C1.5編寫的)。

?

.在使用DLL時有一些基本規(guī)則
??? 一個DLL在被裝入內(nèi)存后,只會有一個實例,不會因為多個程序使用同一個DLL而在內(nèi)存中產(chǎn)生多個DLL拷貝,每個DLL只有一個最大為64K的數(shù)據(jù)段。缺省情況下,PowerBuilder都是使用傳值法來傳遞參數(shù)。當(dāng)你在函數(shù)應(yīng)用說明時使用了REF關(guān)鍵字,PowerBuilder將傳遞一個32位的地址指針(段地址+偏移量)給被調(diào)用的函數(shù),而不象一般情況下只傳遞偏移量。這才能保證DLL中的函數(shù)能得到PowerBuilder中數(shù)據(jù)的正確地址。在PowerBuilder中沒有的C的數(shù)據(jù)類型可以在PowerBuilder中說明成字節(jié)數(shù)相等的數(shù)據(jù)類型,例如:

int,short,unsigned int,unsigned short,BOOL,WORD 都可以說明為 int。

long,unsigned long,DWORD 都可以說明為 long。

所有的句柄 都可以說明為 int。

LPSTR和LPBYTE 都可以說明為 string。

對于結(jié)構(gòu),要在C和PowerBuilder中做相等的說明。

PowerBuilder不支持函數(shù)指針的傳遞。

如果DLL的參數(shù)需要空指針(NULL),你可以向函數(shù)傳遞一個值為0的長整型。

?

.傳遞參數(shù)實例
1)從DLL的函數(shù)中返回一個整型值
在PowerBuilder中聲明如下:
FUNCION int Find AvailableRAM() LIBRARY"dllsamp.dll"
在Powerscript中的調(diào)用格式
int memavail
memavail=FindAvailableRAM()
在C中的代碼
WORD FAR PASCAL_export FindAvailableRAM(void)
{
? int memavail;
? //find available memory,store in memavail
? ……
? return memavail;
}

2)通過傳值法傳遞一個整型參數(shù)
在PowerScript中聲明如下：
FUNCTION int FindAvailableDiskSpace(int Drive Number) Library "dllsamp.dll"
在PowerBuilder中的調(diào)用格式
int AvailableDiskSpace
AvailableDiskSpace=FindAvailableDiskSpace(1)
在C中的代碼
WORD FAR PASCAL_export FindAvailableDiskSpace(WORD DriveNumber)
{
? int diskspaceavailable;
? //processing to find available disk space for passed DriverNumber
? ......
? return diskspaceavailable;
}

3)通過參考傳值法傳遞一個整型參數(shù)
在PowerBuilder中聲明如下:
SUBROUTINE FindAvailableDiskSpaceonCDrive(REF int bytesAvailable) Library "dllsamp.dll"
如果我們不需要函數(shù)的返回值,可以在PowerBuilder中將該函數(shù)聲明為SUB-ROUTINE。
在PowerScript中的調(diào)用格式：
int bytesAvail
FindAvailableDiskSpceonCDrive(bytesAvail)
在C中的代碼
void FAR PASCAL_export FindAvailableDiskSpaceonCDrive(WORD *bytesavailable )
//processing to get available bytes on C driver
*bytesavailable = (whatever the result of the caculation was);
可見通過參考傳值法,C中的函數(shù)可以直接修改PowerScript中定義的變量。

4)向DLL中的函數(shù)傳遞數(shù)組
傳遞數(shù)值數(shù)組和字符串?dāng)?shù)組的處理方法是相似的,如果你想在函數(shù)中修改PowerScript中的變量,要在傳遞的參數(shù)前加上REF關(guān)鍵字,下面是使用數(shù)組的例子:
在PowerBuilder中聲明如下：
FUNCTION int myfunction(int array1[],int array2[],REF int array3[]) Library "dllsamp.dll"
在C中的代碼
WORD FAR PASCAL_export myfunction(WORD*array1,WORD*array2,WORD*array3)
凡是用參考方法傳遞的參數(shù),都可以出現(xiàn)在付值表達(dá)式的左邊,如:
*array3 = *array1 + *array2;
字符串?dāng)?shù)組的使用方法類似,只是用LPSTR代替WORD。但是如果使用任何與內(nèi)存尋址有關(guān)的C函數(shù),都要使用C中的far版本。例如字符串拷貝函數(shù),應(yīng)該用_fstrcpy而不要用strcpy。

5)向DLL中的函數(shù)傳遞結(jié)構(gòu)
傳遞結(jié)構(gòu)同樣可以使用傳值法和參考方法。用參考方法傳遞的結(jié)構(gòu)可以在C中直接修改在PowerScript中定義的結(jié)構(gòu)成員。PowerBuilder支持結(jié)構(gòu)數(shù)組和嵌套結(jié)構(gòu)的傳遞。傳遞結(jié)構(gòu)時,要在C中說明與PowerScript中完全相同的結(jié)構(gòu),如果C中結(jié)構(gòu)成員的類型與PowerScript中不能完全相同,那么字節(jié)數(shù)應(yīng)相同,通過在C中進(jìn)行強制類型轉(zhuǎn)換來得到正確的參數(shù)值。下面是傳遞結(jié)構(gòu)的例子:
在PowerBuilder中聲明如下：
SUBROUTINE mysub(REF aStruct aStructureName) LIBRARY "dllsamp.dll"
在C中定義如下
typedef struct s_tag{
? char*szString;
? double aNumber;
}*S_PTR;
void mysub(S_PTR answer)
answer->aNumber-12345;
另外,PowerBuilder中Date,Time和Decimal類型不能直接傳遞給C函數(shù),要先轉(zhuǎn)換成字符串,再傳遞給C函數(shù)。Double類型不能直接傳遞給Borland C++寫的函數(shù),但是Visual C++可以。

?

?

.使用DLL的常見錯誤和需要注意的地方
1)導(dǎo)致GP錯(general protection fault)
在Windows中,如果你企圖訪問不是屬于你的應(yīng)用程序的內(nèi)存將導(dǎo)致GP錯。導(dǎo)致GP錯的原因可能有以下幾點:
a.向DLL中的函數(shù)傳遞了不正確的參數(shù)。這種錯誤是比較難調(diào)試的,因為PowerBuilder的調(diào)試器不能跟蹤到C程序中。你可以通過在C中使用MessgaeBox函數(shù)顯示調(diào)用參數(shù)的方法來檢查參數(shù)傳遞的正確性。更全面的方法是使用Windows的調(diào)試版本(帶有調(diào)試信息的Windows環(huán)境)和功能更強的調(diào)試器(Soft-ice for windows)。
b.C中對數(shù)組的訪問超出了PowerBuilder中申請的邊界。
在C中是不作數(shù)組邊界檢查的,這可能是導(dǎo)致GP錯的最常見的原因!
c.使用了已經(jīng)釋放的內(nèi)存指針。你最好把已經(jīng)釋放的內(nèi)存指針置為NULL,以便在使用前進(jìn)行判斷。

?

2)使用遠(yuǎn)指針
在C中,所有的靜態(tài)變量和全局變量都是在程序的堆中分配的,其他變量都是在堆棧中分配的。DLL可以有自己的數(shù)據(jù)段,但是它沒有堆棧段,因此使用調(diào)用程序的堆棧。這就意味著DS指向DLL 的數(shù)據(jù)段,SS指向PowerBuilder應(yīng)用程序的堆棧。在一般的Windwos應(yīng)用程序中,DS和SS是相同的,你可以使用近指針但在DLL中必須使用32的遠(yuǎn)指針。

?

3)注意靜態(tài)變量的使用
無論有多少實例調(diào)用同一個DLL,在內(nèi)存中只有一份DLL代碼。
由于Windows是多任務(wù)的環(huán)境,因此DLL中的靜態(tài)變量可能由于其他實例對此DLL的調(diào)用而改變!

?

4)不要試圖共享文件句柄
在Windows環(huán)境下,不可能在應(yīng)用程序和DLL間共享文件句柄。每個應(yīng)用有各自的文件句柄表,如果兩個應(yīng)用通過一個DLL來訪問同一文件,它們必須分別打開這個文件。

?

5)及時地釋放使用過的資源
如果你的DLL中使用了GDI對象,一定要及時釋放它們,否則會使Windows因申請GDI資源失敗而死住!例如你建立了一個邏輯字體或邏輯筆,在使用完后,要用DeleteObject來刪除它。