1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
/*
* openvpnmsica -- Custom Action DLL to provide OpenVPN-specific support to MSI packages
* https://community.openvpn.net/openvpn/wiki/OpenVPNMSICA
*
* Copyright (C) 2018-2021 Simon Rozman <simon@rozman.si>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2
* as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
#ifndef MSIHLP_H
#define MSIHLP_H
#include <windows.h>
#include <msi.h>
#include "../tapctl/basic.h"
/**
* Gets MSI property value
*
* @param hInstall Handle to the installation provided to the DLL custom action
*
* @param szName Property name
*
* @param pszValue Pointer to string to retrieve property value. The string must
* be released with free() after use.
*
* @return ERROR_SUCCESS on success; Win32 error code otherwise
*/
UINT
msi_get_string(
_In_ MSIHANDLE hInstall,
_In_z_ LPCTSTR szName,
_Out_ LPTSTR *pszValue);
/**
* Gets MSI record string value
*
* @param hRecord Handle to the record
*
* @param iField Field index
*
* @param pszValue Pointer to string to retrieve field value. The string must be
* released with free() after use.
*
* @return ERROR_SUCCESS on success; Win32 error code otherwise
*/
UINT
msi_get_record_string(
_In_ MSIHANDLE hRecord,
_In_ unsigned int iField,
_Out_ LPTSTR *pszValue);
/**
* Formats MSI record
*
* @param hInstall Handle to the installation. This may be omitted, in which case only the
* record field parameters are processed and properties are not available
* for substitution.
*
* @param hRecord Handle to the record to format. The template string must be stored in
* record field 0 followed by referenced data parameters.
*
* @param pszValue Pointer to string to retrieve formatted value. The string must be
* released with free() after use.
*
* @return ERROR_SUCCESS on success; Win32 error code otherwise
*/
UINT
msi_format_record(
_In_ MSIHANDLE hInstall,
_In_ MSIHANDLE hRecord,
_Out_ LPTSTR *pszValue);
/**
* Formats MSI record field
*
* @param hInstall Handle to the installation. This may be omitted, in which case only the
* record field parameters are processed and properties are not available
* for substitution.
*
* @param hRecord Handle to the field record
*
* @param iField Field index
*
* @param pszValue Pointer to string to retrieve formatted value. The string must be
* released with free() after use.
*
* @return ERROR_SUCCESS on success; Win32 error code otherwise
*/
UINT
msi_format_field(
_In_ MSIHANDLE hInstall,
_In_ MSIHANDLE hRecord,
_In_ unsigned int iField,
_Out_ LPTSTR *pszValue);
#endif /* ifndef MSIHLP_H */
|
