| /* | |
| * apih | |
| * | |
| * This file is a part of NSIS. | |
| * | |
| * Copyright (C) 1999-2013 Nullsoft and Contributors | |
| * | |
| * Licensed under the zlib/libpng license (the "License"); | |
| * you may not use this file except in compliance with the License. | |
| * | |
| * Licence details can be found in the file COPYING. | |
| * | |
| * This software is provided 'as-is', without any express or implied | |
| * warranty. | |
| */ | |
| // Starting with NSIS 2.42, you can check the version of the plugin API in exec_flags->plugin_api_version | |
| // The format is 0xXXXXYYYY where X is the major version and Y is the minor version (MAKELONG(y,x)) | |
| // When doing version checks, always remember to use >=, ex: if (pX->exec_flags->plugin_api_version >= NSISPIAPIVER_1_0) {} | |
| // NSIS Plug-In Callback Messages | |
| enum NSPIM | |
| { | |
| NSPIM_UNLOAD, // This is the last message a plugin gets, do final cleanup | |
| NSPIM_GUIUNLOAD, // Called after .onGUIEnd | |
| }; | |
| // Prototype for callbacks registered with extra_parameters->RegisterPluginCallback() | |
| // Return NULL for unknown messages | |
| // Should always be __cdecl for future expansion possibilities | |
| typedef UINT_PTR (*NSISPLUGINCALLBACK)(enum NSPIM); | |
| // extra_parameters data structures containing other interesting stuff | |
| // but the stack, variables and HWND passed on to plug-ins. | |
| typedef struct | |
| { | |
| int autoclose; | |
| int all_user_var; | |
| int exec_error; | |
| int abort; | |
| int exec_reboot; // NSIS_SUPPORT_REBOOT | |
| int reboot_called; // NSIS_SUPPORT_REBOOT | |
| int XXX_cur_insttype; // depreacted | |
| int plugin_api_version; // see NSISPIAPIVER_CURR | |
| // used to be XXX_insttype_changed | |
| int silent; // NSIS_CONFIG_SILENT_SUPPORT | |
| int instdir_error; | |
| int rtl; | |
| int errlvl; | |
| int alter_reg_view; | |
| int status_update; | |
| } exec_flags_t; | |
| typedef struct { | |
| exec_flags_t *exec_flags; | |
| int (NSISCALL *ExecuteCodeSegment)(int, HWND); | |
| void (NSISCALL *validate_filename)(LPTSTR); | |
| int (NSISCALL *RegisterPluginCallback)(HMODULE, NSISPLUGINCALLBACK); // returns 0 on success, 1 if already registered and < 0 on errors | |
| } extra_parameters; | |
| // Definitions for page showing plug-ins | |
| // See Ui.c to understand better how they're used | |
| // sent to the outer window to tell it to go to the next inner window | |
| // custom pages should send this message to let NSIS know they're ready | |
| // sent as wParam with WM_NOTIFY_OUTER_NEXT when user cancels - heed its warning | |