lotus API Data Type
LotusScript Data Type
char, char*
ByVal String
char far*
ByVal String
int
Long (4-byte value)
long
Long
WORD, SWORD
Integer
DWORD
Long
INT, UINT
Integer
SHORT, USHORT
Integer
LONG, ULONG
Long
NUMBER
Double
BOOL
Long (in general,
sometimes Integer)
BYTE, BOOLBYTE
Byte in R5+,
cannot convert pre-R5
STATUS
Integer
HANDLE
Long (Integer on Mac
and some UNIX)
HMODULE
Long
NULL
ByVal Integer (0)
In general, when you have a pointer (*) to a variable, you'll want to pass that parameter ByRef, otherwise you should pass it ByVal -- the exceptions are Strings (which you should pretty much always pass ByVal) and user-defined data types (which you have to pass ByRef). If you want to pass a NULL value to an API function, declare the parameter as an Integer and pass a zero ByVal.
As an example, these two commonly-used API functions:
STATUS LNPUBLIC NSFDbOpen(char far *PathName, DBHANDLE far *rethDB);
STATUS LNPUBLIC NSFDbClose(DBHANDLE hDB);
are defined like this in LotusScript (on a Windows platform):
Declare Function NSFDbOpen Lib "nnotes.dll" (Byval PathName As String, _
rethDB As Long) As Integer
Declare Function NSFDbClose Lib "nnotes.dll" (Byval hDB As Long) As Integer
Note that the function's return value (STATUS, in this case) is at the beginning of the function declaration in C, and the LNPUBLIC part of the function gets thrown away (that's just the calling convention in C, and has nothing to do with your LotusScript calls). If a C function returns "void", you can treat it like a Sub.
来自nsftool
