最新消息:

System.dll的使用说明

nsis 永恒心锁 3278浏览 0评论

Contents

  • 1 Description
  • 2 Some background about System.dll
  • 3 Data Types
  • 4 Mapping System.dll variables to NSIS script variables
  • 5 Using System.dll::Call
  • 6 Before starting to code the NSIS script
  • 7 Function Definition
  • 8 Using the external dll function
  • 9 Acknowledgements & Thanks

Description

Some install processes are required to call functions contained inside third party DLL files. A prime example of this is when installing a Palm(TM) conduit.

Some background about System.dll

The System.dll plug-in (by Brainsucker) enables calling of external DLL files by providing the ‘Call’ function. There are a number of other functions provided by System.dll, but they will not be covered here. For more details about the other functions, lock the doors, take the phone off the hook, screw your head on *real* tight and head on over to the Contrib/System directory and read the documentation there.

Data Types

System.dll recognises the following data types:

  • v – void (generally for return)
  • i – int (includes char, byte, short, handles, pointers and so on)
  • l – long & large integer (know as int64)
  • t – text, string (LPCSTR, pointer to first character)
  • b – boolean (needs/returns ‘true’:’false’) – by the fact this type is senseless -> usual integer can be used (‘0′:’1’)
  • k – callback. See Callback section in system.txt.
  • * – pointer specifier -> the proc needs the pointer to type, affects next char (parameter) [ex: ‘*i’ – pointer to int]

Mapping System.dll variables to NSIS script variables

There’s not much point in being able to call an external function if you can’t get any data back. System.dll maps function variables to NSIS script variables in the following way:

   NSIS $0..$9 become System.dll r0..r9
   NSIS $R0..$R9 become System.dll r10..r19

Each parameter is specified by type, input and output. To skip input or output use a dot. Examples:

String (pointer to a characters array), input is ‘happy calling’: t ‘happy calling’

String (pointer to a characters array), input is taken from $5 and changes to the array made by the call are saved into $R8: t r5r18

Pointer to an integer, value taken from $1 and put into $2: *i r1r2

Pointer to a 64-bit integer, output pushed on stack, no input: *l .s

Using System.dll::Call

To call a function in a third party DLL, the Call function is used like this:

System::Call 'YourDllName::YourDllFunction(i, *i, t) i(.r0, r1, .r2) .r3'

The

'(.r0, r1, .r2) .r3'

section at the end are the parameters that are passed between your DLL and your NSIS script. As can be seen in this parameters list type and input/output can be separated. Each block of “(parms list) return value” overrides and/or adds to the last one. In this case, the first block specifies the types and the second specifies input and output.

Before starting to code the NSIS script

Before you start to code any NSIS code, you need to know the full prototype of the function you are going to call. For the purposes of this example, we will use the ‘CmGetHotSyncExecPath’ function from the Palm ‘CondMgr.dll’. This function is used to return the full path of ‘HotSync.exe’.

Function Definition

int CmGetHotSyncExecPath(TCHAR *pPath, int *piSize);

where

  • *pPath is a pointer to a character buffer. Upon return, this is the path & file name of the installed HotSync manager.
  • *piSize is a pointer to an integer that specifies the size (in TCHAR’s), of the buffer referenced by the pPath parameter.

Return values:

  • 0: No error
  • -1: A non-specific error occurred
  • ERR_REGISTRY_ACCESS(-1006):Unable to access the Palm configuration entries
  • ERR_BUFFER_TOO_SMALL(-1010): The buffer is too small to hold the requested information
  • ERR_INVALID_POINTER(-1013):The specified pointer is not a valid pointer</ul>

Also, if the buffer is too small the value in *int is the size (in TCHARs) that the buffer should be.

This function definition maps to the following System.dll definition:

CmGetHotSyncExecPath(t, *i) i

i.e. It takes a text variable, a pointer to int, and returns an int value.

Using the external dll function

Now that we’ve sorted out what the function does, and how it maps to the System.dll format, we can use the function in a NSIS script.

First, it is recommended to turn ‘PluginUnload’ off before making multiple calls to System.dll. According to Brainsucker (and others), this will speed up execution of the installer package.

Second, you have to change the output directory to that where the DLL you want to use is. It may also work if the DLL is on the system path, but this hasn’t been tested.

The following code fragment will install ‘condmgr.dll’ to a temporary directory, execute the CmGetHotSyncExecPath function, display returned data and finally unload the System.dll plug-in.

; **** snip ****
SetPluginUnload  alwaysoff
 
Function loadDll
 
  SetOutPath $TEMPeInspect             ; create temp directory
  File binCondMgr.dll                  ; copy dll there
  StrCpy $1 ${NSIS_MAX_STRLEN}          ; assign memory to $0
  System::Call 'CondMgr::CmGetHotSyncExecPath(t, *i) i(.r0, r1).r2'
  DetailPrint 'Path: "$0"'
  DetailPrint "Path length: $1"
  DetailPrint "Return value: $2"
 
; last plugin call must not have /NOUNLOAD so NSIS will be able to delete 
; the temporary DLL
 
  SetPluginUnload manual
; do nothing (but let the installer unload the System dll)
  System::Free 0
FunctionEnd
; **** snip ****

and this function produces the following output in the ‘details’ page:

Output folder: c:windowsTEMPeInspect
Extract: CondMgr.dll
Path: "C:DavepalmHotsync.exe"
Path length: 24
Return value: 0

免责声明:根据《计算机软件保护条例》第十七条规定“为了学习和研究软件内含的设计思想和原理,通过安装、显示、传输或者存储软件等方式使用软件的,可以不经软件著作权人许可,不向其支付报酬。”您需知晓本站所有内容资源均来源于网络,仅供用户交流学习与研究使用,版权归属原版权方所有,版权争议与本站无关,用户本人下载后不能用作商业或非法用途,需在24个小时之内从您的电脑中彻底删除上述内容,否则后果均由用户承担责任;如果您访问和下载此文件,表示您同意只将此文件用于参考、学习而非其他用途,否则一切后果请您自行承担,如果您喜欢该程序,请支持正版软件,购买注册,得到更好的正版服务。丨本站为个人博客非盈利性站点,所有软件信息均来自网络,所有资源仅供学习参考研究目的,并不贩卖软件,不存在任何商业目的及用途。丨本文采用知识共享 署名4.0国际许可协议 [BY-NC-SA] 进行授权BY-NC-SA协议进行授权

转载请注明:永恒心锁-分享互联网 » System.dll的使用说明

发表我的评论
取消评论
表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址