#include <windows.h>
#include <msi.h>
#include "../tapctl/basic.h"

Include dependency graph for openvpnmsica.h:

This graph shows which files directly or indirectly include this file:

Data Structures
struct	openvpnmsica_thread_data
	Thread local storage data. More...

Macros
#define	ERROR_MSICA 2550L

#define	ERROR_MSICA_ERRNO 2551L

#define	OPENVPNMSICA_SAVE_MSI_SESSION(hInstall)
	Set MSI session handle in thread local storage.

#define	DLLEXP_DECL

#define	DLLEXP_EXPORT "/EXPORT:" __FUNCTION__ "=" __FUNCDNAME__

Functions
DLLEXP_DECL UINT __stdcall	FindSystemInfo (_In_ MSIHANDLE hInstall)
	Determines Windows information:

DLLEXP_DECL UINT __stdcall	CloseOpenVPNGUI (_In_ MSIHANDLE hInstall)
	Find OpenVPN GUI window and send it a WM_CLOSE message.

DLLEXP_DECL UINT __stdcall	StartOpenVPNGUI (_In_ MSIHANDLE hInstall)
	Launches OpenVPN GUI.

DLLEXP_DECL UINT __stdcall	EvaluateTUNTAPAdapters (_In_ MSIHANDLE hInstall)
	Evaluate the TUNTAPAdapter table of the MSI package database and prepare a list of TAP adapters to install/remove.

DLLEXP_DECL UINT __stdcall	ProcessDeferredAction (_In_ MSIHANDLE hInstall)
	Perform scheduled deferred action.

DLLEXP_DECL UINT __stdcall	CheckAndScheduleReboot (_In_ MSIHANDLE hInstall)
	Schedule reboot after installation if reboot indication file is found in user's temp directory.

Variables
DWORD	openvpnmsica_thread_data_idx
	MSI session handle thread local storage index.

Macro Definition Documentation

◆ DLLEXP_DECL

#define DLLEXP_DECL

Definition at line 77 of file openvpnmsica.h.

◆ DLLEXP_EXPORT

#define DLLEXP_EXPORT "/EXPORT:" __FUNCTION__ "=" __FUNCDNAME__

Definition at line 78 of file openvpnmsica.h.

◆ ERROR_MSICA

#define ERROR_MSICA 2550L

Definition at line 31 of file openvpnmsica.h.

◆ ERROR_MSICA_ERRNO

#define ERROR_MSICA_ERRNO 2551L

Definition at line 32 of file openvpnmsica.h.

◆ OPENVPNMSICA_SAVE_MSI_SESSION

#define OPENVPNMSICA_SAVE_MSI_SESSION ( hInstall )

Value:

    {                                                                                     \
        struct openvpnmsica_thread_data *s =                                              \
            (struct openvpnmsica_thread_data *)TlsGetValue(openvpnmsica_thread_data_idx); \
        s->hInstall = (hInstall);                                                         \
    }

Set MSI session handle in thread local storage.

Definition at line 53 of file openvpnmsica.h.

Function Documentation

◆ CheckAndScheduleReboot()

DLLEXP_DECL UINT __stdcall CheckAndScheduleReboot ( _In_ MSIHANDLE hInstall )

Schedule reboot after installation if reboot indication file is found in user's temp directory.

Parameters

hInstall Handle to the installation provided to the DLL custom action

Returns: ERROR_SUCCESS on success; An error code otherwise See: https://msdn.microsoft.com/en-us/library/windows/desktop/aa368072.aspx

Definition at line 1169 of file openvpnmsica.c.

References debug_popup, FILE_NEED_REBOOT, M_WARN, msg, and OPENVPNMSICA_SAVE_MSI_SESSION.

◆ CloseOpenVPNGUI()

DLLEXP_DECL UINT __stdcall CloseOpenVPNGUI ( _In_ MSIHANDLE hInstall )

Find OpenVPN GUI window and send it a WM_CLOSE message.

Parameters

hInstall Handle to the installation provided to the DLL custom action

Returns: ERROR_SUCCESS on success; An error code otherwise See: https://msdn.microsoft.com/en-us/library/windows/desktop/aa368072.aspx

Definition at line 338 of file openvpnmsica.c.

References debug_popup.

◆ EvaluateTUNTAPAdapters()

DLLEXP_DECL UINT __stdcall EvaluateTUNTAPAdapters ( _In_ MSIHANDLE hInstall )

Evaluate the TUNTAPAdapter table of the MSI package database and prepare a list of TAP adapters to install/remove.

Parameters

hInstall Handle to the installation provided to the DLL custom action

Returns: ERROR_SUCCESS on success; An error code otherwise See: https://msdn.microsoft.com/en-us/library/windows/desktop/aa368072.aspx

Definition at line 623 of file openvpnmsica.c.

References debug_popup, M_ERRNO, M_NONFATAL, msg, msi_format_field(), msi_get_record_string(), msica_arg_seq_add_tail(), msica_arg_seq_free(), msica_arg_seq_init(), OPENVPNMSICA_SAVE_MSI_SESSION, schedule_adapter_create(), schedule_adapter_delete(), and setup_sequence().

◆ FindSystemInfo()

DLLEXP_DECL UINT __stdcall FindSystemInfo ( _In_ MSIHANDLE hInstall )

Determines Windows information:

Sets OPENVPNSERVICE MSI property to PID of OpenVPN Service if running, or its EXE path if configured for auto-start.
Finds existing TAP-Windows6 adapters and set TAPWINDOWS6ADAPTERS and ACTIVETAPWINDOWS6ADAPTERS properties with semicolon delimited list of all installed adapter GUIDs and active adapter GUIDs respectively.
Finds existing ovpn-dco adapters and set OVPNDCOADAPTERS and ACTIVEOVPNDCOADAPTERS properties with semicolon delimited list of all installed adapter GUIDs and active adapter GUIDs respectively.

Parameters

hInstall Handle to the installation provided to the DLL custom action

Returns: ERROR_SUCCESS on success; An error code otherwise See: https://msdn.microsoft.com/en-us/library/windows/desktop/aa368072.aspx

Definition at line 311 of file openvpnmsica.c.

References _L, debug_popup, find_adapters(), and OPENVPNMSICA_SAVE_MSI_SESSION.

◆ ProcessDeferredAction()

DLLEXP_DECL UINT __stdcall ProcessDeferredAction ( _In_ MSIHANDLE hInstall )

Perform scheduled deferred action.

Parameters

hInstall Handle to the installation provided to the DLL custom action

Returns: ERROR_SUCCESS on success; An error code otherwise See: https://msdn.microsoft.com/en-us/library/windows/desktop/aa368072.aspx

Definition at line 966 of file openvpnmsica.c.

References cleanup(), CreateRebootFile(), debug_popup, tap_adapter_node::guid, i, M_ERRNO, M_NONFATAL, msg, msi_get_string(), MSICA_ADAPTER_TICK_SIZE, OPENVPNMSICA_SAVE_MSI_SESSION, parse_guid(), tap_adapter_node::pNext, tap_adapter_node::szName, tap_create_adapter(), tap_delete_adapter(), tap_enable_adapter(), tap_free_adapter_list(), tap_list_adapters(), and tap_set_adapter_name().

◆ StartOpenVPNGUI()

DLLEXP_DECL UINT __stdcall StartOpenVPNGUI ( _In_ MSIHANDLE hInstall )

Launches OpenVPN GUI.

It's path is obtained by expanding the [#bin.openvpn_gui.exe] therefore, its Id field in File table must be "bin.openvpn_gui.exe".

Parameters

hInstall Handle to the installation provided to the DLL custom action

Returns: ERROR_SUCCESS on success; An error code otherwise See: https://msdn.microsoft.com/en-us/library/windows/desktop/aa368072.aspx

Definition at line 362 of file openvpnmsica.c.

References debug_popup, M_ERRNO, M_FATAL, M_NONFATAL, msg, and OPENVPNMSICA_SAVE_MSI_SESSION.

Variable Documentation

◆ openvpnmsica_thread_data_idx

DWORD openvpnmsica_thread_data_idx

extern

MSI session handle thread local storage index.

Definition at line 37 of file dllmain.c.

Referenced by DllMain(), and x_msg_va().

Data Structures

Macros

Functions

Variables

Macro Definition Documentation

◆ DLLEXP_DECL

◆ DLLEXP_EXPORT

◆ ERROR_MSICA

◆ ERROR_MSICA_ERRNO

◆ OPENVPNMSICA_SAVE_MSI_SESSION

Function Documentation

◆ CheckAndScheduleReboot()

◆ CloseOpenVPNGUI()

◆ EvaluateTUNTAPAdapters()

◆ FindSystemInfo()

◆ ProcessDeferredAction()

◆ StartOpenVPNGUI()

Variable Documentation

◆ openvpnmsica_thread_data_idx