Description:
Return the full release string as seen in the Version tab of the File Properties dialog box.
Declaration:
Declare Function GetII2LNVersion Lib "VCII2LN.DLL" (_
Byval strOutBuf As String, _
Byval iLenOfOutBuf As Integer) As Integer
Parameters:
Param |
Description |
strOutBuf |
String, in/out variable, will contain the release string after processing |
iLenOfOutBuf |
Maximum length of strOutBuf. II2LN will not fill in data beyond this length of strOutBuf. |
Returns:
The length of the release string as an Integer. In addition, the release string is copied into the first variable strOutBuf. See notes below on how to strip off trailing blanks!
Usage:
' Make a string large enough for the version string
Dim strVersionBuf As String * 255
Dim strTmp As String
' Hold the length of the returned buffer
Dim iLenOfReturnedBuf As Integer
iLenOfReturnedBuf = GetII2LNVersion(strVersionBuf, 255)
' Strip of trailing blanks
strTmp = Left$(strVersionBuf, iLenOfReturnedBuf)
Notes:
This function return a string to LotusScript. Such logic is always a bit cumbersome to work with in LotusScript. First of all, you must define a String with a specific length. In the sample above, this is the number 255. If you don't declare the String in this way, you will declare a string with too small size for the function to work properly. When the GetII2LNVersion return the length of the content in the output variable (strOutBuf), use that number to strip off trailing blanks. Again, in the sample above, the variable strTmp contains the stripped release string.
Introduced in version:
1.2.0.0