开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 游戏 > 模拟服务器 > 查看源码
Msi.h
资源名称：SwordOnline.rar　[点击查看]
上传用户：dzyhzl
上传日期：2019-04-29
资源大小：56270k
文件大小：68k
源码类别：

模拟服务器

开发平台：

C/C++

Msi.h：源码内容
  2. /*****************************************************************************
  3. *                                                                             *
  4. * msi.h - - Interface for external access to Installer Service                *
  5. *                                                                             *
  6. * Version 2.0                                                                 *
  7. *                                                                             *
  8. * NOTES:  All buffers sizes are TCHAR count, null included only on input      *
  9. *         Return argument pointers may be null if not interested in value     *
  10. *                                                                             *
  11. * Copyright (c) 1996-2001, Microsoft Corp.      All rights reserved.          *
  12. *                                                                             *
  13. *****************************************************************************/
  15. #ifndef _MSI_H_
  16. #define _MSI_H_
  18. #ifndef _WIN32_MSI
  19. #if (_WIN32_WINNT >= 0x0501)
  20. #define _WIN32_MSI   200
  21. #elif (_WIN32_WINNT >= 0x0500)
  22. #define _WIN32_MSI   110
  23. #else
  24. #define _WIN32_MSI   100
  25. #endif //_WIN32_WINNT
  26. #endif // !_WIN32_MSI
  28. #if (_WIN32_MSI >= 150)
  29. #ifndef _MSI_NO_CRYPTO
  30. #include "wincrypt.h"
  31. #endif // _MSI_NO_CRYPTO
  32. #endif //(_WIN32_MSI >= 150)
  34. // --------------------------------------------------------------------------
  35. // Installer generic handle definitions
  36. // --------------------------------------------------------------------------
  38. typedef unsigned long MSIHANDLE;     // abstract generic handle, 0 == no handle
  40. #ifdef __cplusplus
  41. extern "C" {
  42. #endif
  44. // Close a open handle of any type
  45. // All handles obtained from API calls must be closed when no longer needed
  46. // Normally succeeds, returning TRUE. 
  48. UINT WINAPI MsiCloseHandle(MSIHANDLE hAny);
  50. // Close all handles open in the process, a diagnostic call
  51. // This should NOT be used as a cleanup mechanism -- use PMSIHANDLE class
  52. // Can be called at termination to assure that all handles have been closed
  53. // Returns 0 if all handles have been close, else number of open handles
  55. UINT WINAPI MsiCloseAllHandles();
  57. #ifdef __cplusplus
  58. }
  59. #endif
  61. #ifdef __cplusplus
  63. // C++ wrapper object to automatically free handle when going out of scope
  65. class PMSIHANDLE
  66. {
  67. MSIHANDLE m_h;
  68.  public:
  69. PMSIHANDLE():m_h(0){}
  70. PMSIHANDLE(MSIHANDLE h):m_h(h){}
  71.   ~PMSIHANDLE(){if (m_h!=0) MsiCloseHandle(m_h);}
  72. void operator =(MSIHANDLE h) {if (m_h) MsiCloseHandle(m_h); m_h=h;}
  73. operator MSIHANDLE() {return m_h;}
  74. MSIHANDLE* operator &() {if (m_h) MsiCloseHandle(m_h); m_h = 0; return &m_h;}
  75. };
  76. #endif  //__cplusplus
  78. // Install message type for callback is a combination of the following:
  79. //  A message box style:      MB_*, where MB_OK is the default
  80. //  A message box icon type:  MB_ICON*, where no icon is the default
  81. //  A default button:         MB_DEFBUTTON?, where MB_DEFBUTTON1 is the default
  82. //  One of the following install message types, no default
  83. typedef enum tagINSTALLMESSAGE
  84. {
  85. INSTALLMESSAGE_FATALEXIT      = 0x00000000L, // premature termination, possibly fatal OOM
  86. INSTALLMESSAGE_ERROR          = 0x01000000L, // formatted error message
  87. INSTALLMESSAGE_WARNING        = 0x02000000L, // formatted warning message
  88. INSTALLMESSAGE_USER           = 0x03000000L, // user request message
  89. INSTALLMESSAGE_INFO           = 0x04000000L, // informative message for log
  90. INSTALLMESSAGE_FILESINUSE     = 0x05000000L, // list of files in use that need to be replaced
  91. INSTALLMESSAGE_RESOLVESOURCE  = 0x06000000L, // request to determine a valid source location
  92. INSTALLMESSAGE_OUTOFDISKSPACE = 0x07000000L, // insufficient disk space message
  93. INSTALLMESSAGE_ACTIONSTART    = 0x08000000L, // start of action: action name & description
  94. INSTALLMESSAGE_ACTIONDATA     = 0x09000000L, // formatted data associated with individual action item
  95. INSTALLMESSAGE_PROGRESS       = 0x0A000000L, // progress gauge info: units so far, total
  96. INSTALLMESSAGE_COMMONDATA     = 0x0B000000L, // product info for dialog: language Id, dialog caption
  97. INSTALLMESSAGE_INITIALIZE     = 0x0C000000L, // sent prior to UI initialization, no string data
  98. INSTALLMESSAGE_TERMINATE      = 0x0D000000L, // sent after UI termination, no string data
  99. INSTALLMESSAGE_SHOWDIALOG     = 0x0E000000L, // sent prior to display or authored dialog or wizard
  100. } INSTALLMESSAGE;
  102. // external error handler supplied to installation API functions
  103. typedef int (WINAPI *INSTALLUI_HANDLERA)(LPVOID pvContext, UINT iMessageType, LPCSTR szMessage);
  104. // external error handler supplied to installation API functions
  105. typedef int (WINAPI *INSTALLUI_HANDLERW)(LPVOID pvContext, UINT iMessageType, LPCWSTR szMessage);
  106. #ifdef UNICODE
  107. #define INSTALLUI_HANDLER  INSTALLUI_HANDLERW
  108. #else
  109. #define INSTALLUI_HANDLER  INSTALLUI_HANDLERA
  110. #endif // !UNICODE
  112. typedef enum tagINSTALLUILEVEL
  113. {
  114. INSTALLUILEVEL_NOCHANGE = 0,    // UI level is unchanged
  115. INSTALLUILEVEL_DEFAULT  = 1,    // default UI is used
  116. INSTALLUILEVEL_NONE     = 2,    // completely silent installation
  117. INSTALLUILEVEL_BASIC    = 3,    // simple progress and error handling
  118. INSTALLUILEVEL_REDUCED  = 4,    // authored UI, wizard dialogs suppressed
  119. INSTALLUILEVEL_FULL     = 5,    // authored UI with wizards, progress, errors
  120. INSTALLUILEVEL_ENDDIALOG    = 0x80, // display success/failure dialog at end of install
  121. INSTALLUILEVEL_PROGRESSONLY = 0x40, // display only progress dialog
  122. INSTALLUILEVEL_HIDECANCEL   = 0x20, // do not display the cancel button in basic UI
  123. INSTALLUILEVEL_SOURCERESONLY = 0x100, // force display of source resolution even if quiet
  124. } INSTALLUILEVEL;
  126. typedef enum tagINSTALLSTATE
  127. {
  128. INSTALLSTATE_NOTUSED      = -7,  // component disabled
  129. INSTALLSTATE_BADCONFIG    = -6,  // configuration data corrupt
  130. INSTALLSTATE_INCOMPLETE   = -5,  // installation suspended or in progress
  131. INSTALLSTATE_SOURCEABSENT = -4,  // run from source, source is unavailable
  132. INSTALLSTATE_MOREDATA     = -3,  // return buffer overflow
  133. INSTALLSTATE_INVALIDARG   = -2,  // invalid function argument
  134. INSTALLSTATE_UNKNOWN      = -1,  // unrecognized product or feature
  135. INSTALLSTATE_BROKEN       =  0,  // broken
  136. INSTALLSTATE_ADVERTISED   =  1,  // advertised feature
  137. INSTALLSTATE_REMOVED      =  1,  // component being removed (action state, not settable)
  138. INSTALLSTATE_ABSENT       =  2,  // uninstalled (or action state absent but clients remain)
  139. INSTALLSTATE_LOCAL        =  3,  // installed on local drive
  140. INSTALLSTATE_SOURCE       =  4,  // run from source, CD or net
  141. INSTALLSTATE_DEFAULT      =  5,  // use default, local or source
  142. } INSTALLSTATE;
  144. typedef enum tagUSERINFOSTATE
  145. {
  146. USERINFOSTATE_MOREDATA   = -3,  // return buffer overflow
  147. USERINFOSTATE_INVALIDARG = -2,  // invalid function argument
  148. USERINFOSTATE_UNKNOWN    = -1,  // unrecognized product
  149. USERINFOSTATE_ABSENT     =  0,  // user info and PID not initialized
  150. USERINFOSTATE_PRESENT    =  1,  // user info and PID initialized
  151. } USERINFOSTATE;
  153. typedef enum tagINSTALLLEVEL
  154. {
  155. INSTALLLEVEL_DEFAULT = 0,      // install authored default
  156. INSTALLLEVEL_MINIMUM = 1,      // install only required features
  157. INSTALLLEVEL_MAXIMUM = 0xFFFF, // install all features
  158. } INSTALLLEVEL;                   // intermediate levels dependent on authoring
  160. typedef enum tagREINSTALLMODE  // bit flags
  161. {
  162. REINSTALLMODE_REPAIR           = 0x00000001,  // Reserved bit - currently ignored
  163. REINSTALLMODE_FILEMISSING      = 0x00000002,  // Reinstall only if file is missing
  164. REINSTALLMODE_FILEOLDERVERSION = 0x00000004,  // Reinstall if file is missing, or older version
  165. REINSTALLMODE_FILEEQUALVERSION = 0x00000008,  // Reinstall if file is missing, or equal or older version
  166. REINSTALLMODE_FILEEXACT        = 0x00000010,  // Reinstall if file is missing, or not exact version
  167. REINSTALLMODE_FILEVERIFY       = 0x00000020,  // checksum executables, reinstall if missing or corrupt
  168. REINSTALLMODE_FILEREPLACE      = 0x00000040,  // Reinstall all files, regardless of version
  169. REINSTALLMODE_MACHINEDATA      = 0x00000080,  // insure required machine reg entries
  170. REINSTALLMODE_USERDATA         = 0x00000100,  // insure required user reg entries
  171. REINSTALLMODE_SHORTCUT         = 0x00000200,  // validate shortcuts items
  172. REINSTALLMODE_PACKAGE          = 0x00000400,  // use re-cache source install package
  173. } REINSTALLMODE;
  175. typedef enum tagINSTALLOGMODE  // bit flags for use with MsiEnableLog and MsiSetExternalUI
  176. {
  177. INSTALLLOGMODE_FATALEXIT      = (1 << (INSTALLMESSAGE_FATALEXIT      >> 24)),
  178. INSTALLLOGMODE_ERROR          = (1 << (INSTALLMESSAGE_ERROR          >> 24)),
  179. INSTALLLOGMODE_WARNING        = (1 << (INSTALLMESSAGE_WARNING        >> 24)),
  180. INSTALLLOGMODE_USER           = (1 << (INSTALLMESSAGE_USER           >> 24)),
  181. INSTALLLOGMODE_INFO           = (1 << (INSTALLMESSAGE_INFO           >> 24)),
  182. INSTALLLOGMODE_RESOLVESOURCE  = (1 << (INSTALLMESSAGE_RESOLVESOURCE  >> 24)),
  183. INSTALLLOGMODE_OUTOFDISKSPACE = (1 << (INSTALLMESSAGE_OUTOFDISKSPACE >> 24)),
  184. INSTALLLOGMODE_ACTIONSTART    = (1 << (INSTALLMESSAGE_ACTIONSTART    >> 24)),
  185. INSTALLLOGMODE_ACTIONDATA     = (1 << (INSTALLMESSAGE_ACTIONDATA     >> 24)),
  186. INSTALLLOGMODE_COMMONDATA     = (1 << (INSTALLMESSAGE_COMMONDATA     >> 24)),
  187. INSTALLLOGMODE_PROPERTYDUMP   = (1 << (INSTALLMESSAGE_PROGRESS       >> 24)), // log only
  188. INSTALLLOGMODE_VERBOSE        = (1 << (INSTALLMESSAGE_INITIALIZE     >> 24)), // log only
  189. INSTALLLOGMODE_PROGRESS       = (1 << (INSTALLMESSAGE_PROGRESS       >> 24)), // external handler only
  190. INSTALLLOGMODE_INITIALIZE     = (1 << (INSTALLMESSAGE_INITIALIZE     >> 24)), // external handler only
  191. INSTALLLOGMODE_TERMINATE      = (1 << (INSTALLMESSAGE_TERMINATE      >> 24)), // external handler only
  192. INSTALLLOGMODE_SHOWDIALOG     = (1 << (INSTALLMESSAGE_SHOWDIALOG     >> 24)), // external handler only
  193. } INSTALLLOGMODE;
  195. typedef enum tagINSTALLLOGATTRIBUTES // flag attributes for MsiEnableLog
  196. {
  197. INSTALLLOGATTRIBUTES_APPEND            = (1 << 0),
  198. INSTALLLOGATTRIBUTES_FLUSHEACHLINE     = (1 << 1),
  199. } INSTALLLOGATTRIBUTES;
  201. typedef enum tagINSTALLFEATUREATTRIBUTE // bit flags
  202. {
  203. INSTALLFEATUREATTRIBUTE_FAVORLOCAL             = 1 << 0,
  204. INSTALLFEATUREATTRIBUTE_FAVORSOURCE            = 1 << 1,
  205. INSTALLFEATUREATTRIBUTE_FOLLOWPARENT           = 1 << 2,
  206. INSTALLFEATUREATTRIBUTE_FAVORADVERTISE         = 1 << 3,
  207. INSTALLFEATUREATTRIBUTE_DISALLOWADVERTISE      = 1 << 4,
  208. INSTALLFEATUREATTRIBUTE_NOUNSUPPORTEDADVERTISE = 1 << 5,
  209. } INSTALLFEATUREATTRIBUTE;
  211. typedef enum tagINSTALLMODE
  212. {
  213. INSTALLMODE_NOSOURCERESOLUTION   = -3,  // skip source resolution
  214. INSTALLMODE_NODETECTION          = -2,  // skip detection
  215. INSTALLMODE_EXISTING             = -1,  // provide, if available
  216. INSTALLMODE_DEFAULT              =  0,  // install, if absent
  217. } INSTALLMODE;
  220. #define MAX_FEATURE_CHARS  38   // maximum chars in feature name (same as string GUID)
  223. // Product info attributes: advertised information
  225. #define INSTALLPROPERTY_PACKAGENAME           __TEXT("PackageName")
  226. #define INSTALLPROPERTY_TRANSFORMS            __TEXT("Transforms")
  227. #define INSTALLPROPERTY_LANGUAGE              __TEXT("Language")
  228. #define INSTALLPROPERTY_PRODUCTNAME           __TEXT("ProductName")
  229. #define INSTALLPROPERTY_ASSIGNMENTTYPE        __TEXT("AssignmentType")
  230. #define INSTALLPROPERTY_PACKAGECODE           __TEXT("PackageCode")
  231. #define INSTALLPROPERTY_VERSION               __TEXT("Version")
  232. #if (_WIN32_MSI >=  110)
  233. #define INSTALLPROPERTY_PRODUCTICON           __TEXT("ProductIcon")
  234. #endif //(_WIN32_MSI >=  110)
  236. // Product info attributes: installed information
  238. #define INSTALLPROPERTY_INSTALLEDPRODUCTNAME  __TEXT("InstalledProductName")
  239. #define INSTALLPROPERTY_VERSIONSTRING         __TEXT("VersionString")
  240. #define INSTALLPROPERTY_HELPLINK              __TEXT("HelpLink")
  241. #define INSTALLPROPERTY_HELPTELEPHONE         __TEXT("HelpTelephone")
  242. #define INSTALLPROPERTY_INSTALLLOCATION       __TEXT("InstallLocation")
  243. #define INSTALLPROPERTY_INSTALLSOURCE         __TEXT("InstallSource")
  244. #define INSTALLPROPERTY_INSTALLDATE           __TEXT("InstallDate")
  245. #define INSTALLPROPERTY_PUBLISHER             __TEXT("Publisher")
  246. #define INSTALLPROPERTY_LOCALPACKAGE          __TEXT("LocalPackage")
  247. #define INSTALLPROPERTY_URLINFOABOUT          __TEXT("URLInfoAbout")
  248. #define INSTALLPROPERTY_URLUPDATEINFO         __TEXT("URLUpdateInfo")
  249. #define INSTALLPROPERTY_VERSIONMINOR          __TEXT("VersionMinor")
  250. #define INSTALLPROPERTY_VERSIONMAJOR          __TEXT("VersionMajor")
  252. typedef enum tagSCRIPTFLAGS
  253. {
  254. SCRIPTFLAGS_CACHEINFO                = 0x00000001L,   // set if the icons need to be created/ removed
  255. SCRIPTFLAGS_SHORTCUTS                = 0x00000004L,   // set if the shortcuts needs to be created/ deleted
  256. SCRIPTFLAGS_MACHINEASSIGN            = 0x00000008L,   // set if product to be assigned to machine
  257. SCRIPTFLAGS_REGDATA_CNFGINFO         = 0x00000020L,   // set if the product cnfg mgmt. registry data needs to be written/ removed
  258. SCRIPTFLAGS_VALIDATE_TRANSFORMS_LIST = 0x00000040L,
  259. #if (_WIN32_MSI >=  110)
  260. SCRIPTFLAGS_REGDATA_CLASSINFO        = 0x00000080L,   // set if COM classes related app info needs to be  created/ deleted
  261. SCRIPTFLAGS_REGDATA_EXTENSIONINFO    = 0x00000100L,   // set if extension related app info needs to be  created/ deleted
  262. SCRIPTFLAGS_REGDATA_APPINFO          = SCRIPTFLAGS_REGDATA_CLASSINFO | SCRIPTFLAGS_REGDATA_EXTENSIONINFO,  // for source level backward compatibility
  263. #else //_WIN32_MSI == 100
  264. SCRIPTFLAGS_REGDATA_APPINFO          = 0x00000010L,
  265. #endif //(_WIN32_MSI >=  110)
  266. SCRIPTFLAGS_REGDATA                  = SCRIPTFLAGS_REGDATA_APPINFO | SCRIPTFLAGS_REGDATA_CNFGINFO, // for source level backward compatibility
  267. }SCRIPTFLAGS;
  270. typedef enum tagADVERTISEFLAGS
  271. {
  272. ADVERTISEFLAGS_MACHINEASSIGN   =    0,   // set if the product is to be machine assigned
  273. ADVERTISEFLAGS_USERASSIGN      =    1,   // set if the product is to be user assigned
  274. }ADVERTISEFLAGS;
  276. typedef enum tagINSTALLTYPE
  277. {
  278. INSTALLTYPE_DEFAULT            =    0,   // set to indicate default behavior
  279. INSTALLTYPE_NETWORK_IMAGE      =    1,   // set to indicate network install
  280. }INSTALLTYPE;
  282. #if (_WIN32_MSI >=  150)
  284. typedef struct _MSIFILEHASHINFO {
  285. ULONG dwFileHashInfoSize;
  286. ULONG dwData [ 4 ];
  287. } MSIFILEHASHINFO, *PMSIFILEHASHINFO;
  289. typedef enum tagMSIARCHITECTUREFLAGS
  290. {
  291. MSIARCHITECTUREFLAGS_X86   = 0x00000001L, // set if creating the script for i386 platform
  292. MSIARCHITECTUREFLAGS_IA64  = 0x00000002L, // set if creating the script for IA64 platform
  293. }MSIARCHITECTUREFLAGS;
  295. typedef enum tagMSIOPENPACKAGEFLAGS
  296. {
  297. MSIOPENPACKAGEFLAGS_IGNOREMACHINESTATE = 0x00000001L, // ignore the machine state when creating the engine
  298. }MSIOPENPACKAGEFLAGS;
  300. #endif //(_WIN32_MSI >=  150)
  303. #ifdef __cplusplus
  304. extern "C" {
  305. #endif
  307. // --------------------------------------------------------------------------
  308. // Functions to set the UI handling and logging. The UI will be used for error,
  309. // progress, and log messages for all subsequent calls to Installer Service
  310. // API functions that require UI.
  311. // --------------------------------------------------------------------------
  313. // Enable internal UI
  315. INSTALLUILEVEL WINAPI MsiSetInternalUI(
  316. INSTALLUILEVEL  dwUILevel,     // UI level
  317. HWND  *phWnd);                   // handle of owner window
  319. // Enable external UI handling, returns any previous handler or NULL if none.
  320. // Messages are designated with a combination of bits from INSTALLLOGMODE enum.
  322. INSTALLUI_HANDLERA WINAPI MsiSetExternalUIA(
  323. INSTALLUI_HANDLERA puiHandler,   // for progress and error handling 
  324. DWORD              dwMessageFilter, // bit flags designating messages to handle
  325. LPVOID             pvContext);   // application context
  326. INSTALLUI_HANDLERW WINAPI MsiSetExternalUIW(
  327. INSTALLUI_HANDLERW puiHandler,   // for progress and error handling 
  328. DWORD              dwMessageFilter, // bit flags designating messages to handle
  329. LPVOID             pvContext);   // application context
  330. #ifdef UNICODE
  331. #define MsiSetExternalUI  MsiSetExternalUIW
  332. #else
  333. #define MsiSetExternalUI  MsiSetExternalUIA
  334. #endif // !UNICODE
  337. // Enable logging to a file for all install sessions for the client process,
  338. // with control over which log messages are passed to the specified log file.
  339. // Messages are designated with a combination of bits from INSTALLLOGMODE enum.
  341. UINT WINAPI MsiEnableLogA(
  342. DWORD     dwLogMode,           // bit flags designating operations to report
  343. LPCSTR  szLogFile,           // log file, or NULL to disable logging
  344. DWORD     dwLogAttributes);    // INSTALLLOGATTRIBUTES flags
  345. UINT WINAPI MsiEnableLogW(
  346. DWORD     dwLogMode,           // bit flags designating operations to report
  347. LPCWSTR  szLogFile,           // log file, or NULL to disable logging
  348. DWORD     dwLogAttributes);    // INSTALLLOGATTRIBUTES flags
  349. #ifdef UNICODE
  350. #define MsiEnableLog  MsiEnableLogW
  351. #else
  352. #define MsiEnableLog  MsiEnableLogA
  353. #endif // !UNICODE
  355. // --------------------------------------------------------------------------
  356. // Functions to query and configure a product as a whole.
  357. // --------------------------------------------------------------------------
  359. // Return the installed state for a product
  361. INSTALLSTATE WINAPI MsiQueryProductStateA(
  362. LPCSTR  szProduct);
  363. INSTALLSTATE WINAPI MsiQueryProductStateW(
  364. LPCWSTR  szProduct);
  365. #ifdef UNICODE
  366. #define MsiQueryProductState  MsiQueryProductStateW
  367. #else
  368. #define MsiQueryProductState  MsiQueryProductStateA
  369. #endif // !UNICODE
  371. // Return product info
  373. UINT WINAPI MsiGetProductInfoA(
  374. LPCSTR   szProduct,      // product code
  375. LPCSTR   szAttribute,    // attribute name, case-sensitive
  376. LPSTR    lpValueBuf,     // returned value, NULL if not desired
  377. DWORD      *pcchValueBuf); // in/out buffer character count
  378. UINT WINAPI MsiGetProductInfoW(
  379. LPCWSTR   szProduct,      // product code
  380. LPCWSTR   szAttribute,    // attribute name, case-sensitive
  381. LPWSTR    lpValueBuf,     // returned value, NULL if not desired
  382. DWORD      *pcchValueBuf); // in/out buffer character count
  383. #ifdef UNICODE
  384. #define MsiGetProductInfo  MsiGetProductInfoW
  385. #else
  386. #define MsiGetProductInfo  MsiGetProductInfoA
  387. #endif // !UNICODE
  389. // Install a new product.
  390. // Either may be NULL, but the DATABASE property must be specfied
  392. UINT WINAPI MsiInstallProductA(
  393. LPCSTR      szPackagePath,    // location of package to install
  394. LPCSTR      szCommandLine);   // command line <property settings>
  395. UINT WINAPI MsiInstallProductW(
  396. LPCWSTR      szPackagePath,    // location of package to install
  397. LPCWSTR      szCommandLine);   // command line <property settings>
  398. #ifdef UNICODE
  399. #define MsiInstallProduct  MsiInstallProductW
  400. #else
  401. #define MsiInstallProduct  MsiInstallProductA
  402. #endif // !UNICODE
  404. // Install/uninstall an advertised or installed product
  405. // No action if installed and INSTALLSTATE_DEFAULT specified
  407. UINT WINAPI MsiConfigureProductA(
  408. LPCSTR      szProduct,        // product code
  409. int          iInstallLevel,    // how much of the product to install
  410. INSTALLSTATE eInstallState);   // local/source/default/absent/lock/uncache
  411. UINT WINAPI MsiConfigureProductW(
  412. LPCWSTR      szProduct,        // product code
  413. int          iInstallLevel,    // how much of the product to install
  414. INSTALLSTATE eInstallState);   // local/source/default/absent/lock/uncache
  415. #ifdef UNICODE
  416. #define MsiConfigureProduct  MsiConfigureProductW
  417. #else
  418. #define MsiConfigureProduct  MsiConfigureProductA
  419. #endif // !UNICODE
  421. // Install/uninstall an advertised or installed product
  422. // No action if installed and INSTALLSTATE_DEFAULT specified
  424. UINT WINAPI MsiConfigureProductExA(
  425. LPCSTR      szProduct,        // product code
  426. int          iInstallLevel,    // how much of the product to install
  427. INSTALLSTATE eInstallState,    // local/source/default/absent/lock/uncache
  428. LPCSTR      szCommandLine);   // command line <property settings>
  429. UINT WINAPI MsiConfigureProductExW(
  430. LPCWSTR      szProduct,        // product code
  431. int          iInstallLevel,    // how much of the product to install
  432. INSTALLSTATE eInstallState,    // local/source/default/absent/lock/uncache
  433. LPCWSTR      szCommandLine);   // command line <property settings>
  434. #ifdef UNICODE
  435. #define MsiConfigureProductEx  MsiConfigureProductExW
  436. #else
  437. #define MsiConfigureProductEx  MsiConfigureProductExA
  438. #endif // !UNICODE
  440. // Reinstall product, used to validate or correct problems
  442. UINT WINAPI MsiReinstallProductA(
  443. LPCSTR      szProduct,        // product code
  444. DWORD         szReinstallMode); // one or more REINSTALLMODE modes
  445. UINT WINAPI MsiReinstallProductW(
  446. LPCWSTR      szProduct,        // product code
  447. DWORD         szReinstallMode); // one or more REINSTALLMODE modes
  448. #ifdef UNICODE
  449. #define MsiReinstallProduct  MsiReinstallProductW
  450. #else
  451. #define MsiReinstallProduct  MsiReinstallProductA
  452. #endif // !UNICODE
  454. #if (_WIN32_MSI >=  150)
  456. // Output reg and shortcut info to script file for specified architecture for Assign or Publish
  457. // If dwPlatform is 0, then the script is created based on the current platform (behavior of MsiAdvertiseProduct)
  458. // If dwPlatform specifies a platform, then the script is created as if the current platform is the
  459. //    platform specified in dwPlatform 
  461. UINT WINAPI MsiAdvertiseProductExA(
  462. LPCSTR szPackagePath,      // location of package
  463. LPCSTR    szScriptfilePath,   // if NULL, product is locally advertised
  464. LPCSTR    szTransforms,       // list of transforms to be applied
  465. LANGID      lgidLanguage,       // install language
  466. DWORD       dwPlatform,         // the MSIARCHITECTUREFLAGS that control for which platform
  467.                                 //   to create the script, ignored if szScriptfilePath is NULL
  468. DWORD       dwReserved);        // reserved for future use -- must be 0
  469. UINT WINAPI MsiAdvertiseProductExW(
  470. LPCWSTR szPackagePath,      // location of package
  471. LPCWSTR    szScriptfilePath,   // if NULL, product is locally advertised
  472. LPCWSTR    szTransforms,       // list of transforms to be applied
  473. LANGID      lgidLanguage,       // install language
  474. DWORD       dwPlatform,         // the MSIARCHITECTUREFLAGS that control for which platform
  475.                                 //   to create the script, ignored if szScriptfilePath is NULL
  476. DWORD       dwReserved);        // reserved for future use -- must be 0
  477. #ifdef UNICODE
  478. #define MsiAdvertiseProductEx  MsiAdvertiseProductExW
  479. #else
  480. #define MsiAdvertiseProductEx  MsiAdvertiseProductExA
  481. #endif // !UNICODE
  483. #endif // (_WIN32_MSI >= 150)
  485. // Output reg and shortcut info to script file for Assign or Publish
  487. UINT WINAPI MsiAdvertiseProductA(
  488. LPCSTR      szPackagePath,    // location of package
  489. LPCSTR      szScriptfilePath,  // if NULL, product is locally advertised
  490. LPCSTR      szTransforms,      // list of transforms to be applied
  491. LANGID        lgidLanguage);     // install language
  492. UINT WINAPI MsiAdvertiseProductW(
  493. LPCWSTR      szPackagePath,    // location of package
  494. LPCWSTR      szScriptfilePath,  // if NULL, product is locally advertised
  495. LPCWSTR      szTransforms,      // list of transforms to be applied
  496. LANGID        lgidLanguage);     // install language
  497. #ifdef UNICODE
  498. #define MsiAdvertiseProduct  MsiAdvertiseProductW
  499. #else
  500. #define MsiAdvertiseProduct  MsiAdvertiseProductA
  501. #endif // !UNICODE
  504. #if (_WIN32_MSI >=  150)
  506. // Process advertise script file into supplied locations
  507. // If an icon folder is specified, icon files will be placed there
  508. // If an registry key is specified, registry data will be mapped under it
  509. // If fShortcuts is TRUE, shortcuts will be created. If a special folder is
  510. //    returned by SHGetSpecialFolderLocation(?), it will hold the shortcuts.
  511. // if fRemoveItems is TRUE, items that are present will be removed
  513. UINT WINAPI MsiProcessAdvertiseScriptA(
  514. LPCSTR      szScriptFile,  // path to script from MsiAdvertiseProduct
  515. LPCSTR      szIconFolder,  // optional path to folder for icon files and transforms
  516. HKEY         hRegData,      // optional parent registry key
  517. BOOL         fShortcuts,    // TRUE if shortcuts output to special folder
  518. BOOL         fRemoveItems); // TRUE if specified items are to be removed
  519. UINT WINAPI MsiProcessAdvertiseScriptW(
  520. LPCWSTR      szScriptFile,  // path to script from MsiAdvertiseProduct
  521. LPCWSTR      szIconFolder,  // optional path to folder for icon files and transforms
  522. HKEY         hRegData,      // optional parent registry key
  523. BOOL         fShortcuts,    // TRUE if shortcuts output to special folder
  524. BOOL         fRemoveItems); // TRUE if specified items are to be removed
  525. #ifdef UNICODE
  526. #define MsiProcessAdvertiseScript  MsiProcessAdvertiseScriptW
  527. #else
  528. #define MsiProcessAdvertiseScript  MsiProcessAdvertiseScriptA
  529. #endif // !UNICODE
  531. #endif // (_WIN32_MSI >= 150)
  534. // Process advertise script file using the supplied dwFlags control flags
  535. // if fRemoveItems is TRUE, items that are present will be removed
  537. UINT WINAPI MsiAdvertiseScriptA(
  538. LPCSTR      szScriptFile,  // path to script from MsiAdvertiseProduct
  539. DWORD         dwFlags,       // the SCRIPTFLAGS bit flags that control the script execution
  540. PHKEY         phRegData,     // optional parent registry key
  541. BOOL          fRemoveItems); // TRUE if specified items are to be removed
  542. UINT WINAPI MsiAdvertiseScriptW(
  543. LPCWSTR      szScriptFile,  // path to script from MsiAdvertiseProduct
  544. DWORD         dwFlags,       // the SCRIPTFLAGS bit flags that control the script execution
  545. PHKEY         phRegData,     // optional parent registry key
  546. BOOL          fRemoveItems); // TRUE if specified items are to be removed
  547. #ifdef UNICODE
  548. #define MsiAdvertiseScript  MsiAdvertiseScriptW
  549. #else
  550. #define MsiAdvertiseScript  MsiAdvertiseScriptA
  551. #endif // !UNICODE
  553. // Return product info from an installer script file:
  554. //   product code, language, version, readable name, path to package
  555. // Returns TRUE is success, FALSE if szScriptFile is not a valid script file
  557. UINT WINAPI MsiGetProductInfoFromScriptA(
  558. LPCSTR  szScriptFile,    // path to installer script file
  559. LPSTR   lpProductBuf39,  // buffer for product code string GUID, 39 chars
  560. LANGID   *plgidLanguage,  // return language Id
  561. DWORD    *pdwVersion,     // return version: Maj:Min:Build <8:8:16>
  562. LPSTR   lpNameBuf,       // buffer to return readable product name
  563. DWORD    *pcchNameBuf,    // in/out name buffer character count
  564. LPSTR   lpPackageBuf,   // buffer for path to product package
  565. DWORD    *pcchPackageBuf);// in/out path buffer character count
  566. UINT WINAPI MsiGetProductInfoFromScriptW(
  567. LPCWSTR  szScriptFile,    // path to installer script file
  568. LPWSTR   lpProductBuf39,  // buffer for product code string GUID, 39 chars
  569. LANGID   *plgidLanguage,  // return language Id
  570. DWORD    *pdwVersion,     // return version: Maj:Min:Build <8:8:16>
  571. LPWSTR   lpNameBuf,       // buffer to return readable product name
  572. DWORD    *pcchNameBuf,    // in/out name buffer character count
  573. LPWSTR   lpPackageBuf,   // buffer for path to product package
  574. DWORD    *pcchPackageBuf);// in/out path buffer character count
  575. #ifdef UNICODE
  576. #define MsiGetProductInfoFromScript  MsiGetProductInfoFromScriptW
  577. #else
  578. #define MsiGetProductInfoFromScript  MsiGetProductInfoFromScriptA
  579. #endif // !UNICODE
  581. // Return the product code for a registered component, called once by apps
  583. UINT WINAPI MsiGetProductCodeA(
  584. LPCSTR   szComponent,   // component Id registered for this product
  585. LPSTR    lpBuf39);      // returned string GUID, sized for 39 characters
  586. UINT WINAPI MsiGetProductCodeW(
  587. LPCWSTR   szComponent,   // component Id registered for this product
  588. LPWSTR    lpBuf39);      // returned string GUID, sized for 39 characters
  589. #ifdef UNICODE
  590. #define MsiGetProductCode  MsiGetProductCodeW
  591. #else
  592. #define MsiGetProductCode  MsiGetProductCodeA
  593. #endif // !UNICODE
  595. // Return the registered user information for an installed product
  597. USERINFOSTATE WINAPI MsiGetUserInfoA(
  598. LPCSTR  szProduct,        // product code, string GUID
  599. LPSTR   lpUserNameBuf,    // return user name           
  600. DWORD    *pcchUserNameBuf, // in/out buffer character count
  601. LPSTR   lpOrgNameBuf,     // return company name           
  602. DWORD    *pcchOrgNameBuf,  // in/out buffer character count
  603. LPSTR   lpSerialBuf,      // return product serial number
  604. DWORD    *pcchSerialBuf);  // in/out buffer character count
  605. USERINFOSTATE WINAPI MsiGetUserInfoW(
  606. LPCWSTR  szProduct,        // product code, string GUID
  607. LPWSTR   lpUserNameBuf,    // return user name           
  608. DWORD    *pcchUserNameBuf, // in/out buffer character count
  609. LPWSTR   lpOrgNameBuf,     // return company name           
  610. DWORD    *pcchOrgNameBuf,  // in/out buffer character count
  611. LPWSTR   lpSerialBuf,      // return product serial number
  612. DWORD    *pcchSerialBuf);  // in/out buffer character count
  613. #ifdef UNICODE
  614. #define MsiGetUserInfo  MsiGetUserInfoW
  615. #else
  616. #define MsiGetUserInfo  MsiGetUserInfoA
  617. #endif // !UNICODE
  619. // Obtain and store user info and PID from installation wizard (first run)
  621. UINT WINAPI MsiCollectUserInfoA(
  622. LPCSTR  szProduct);     // product code, string GUID
  623. UINT WINAPI MsiCollectUserInfoW(
  624. LPCWSTR  szProduct);     // product code, string GUID
  625. #ifdef UNICODE
  626. #define MsiCollectUserInfo  MsiCollectUserInfoW
  627. #else
  628. #define MsiCollectUserInfo  MsiCollectUserInfoA
  629. #endif // !UNICODE
  631. // --------------------------------------------------------------------------
  632. // Functions to patch existing products
  633. // --------------------------------------------------------------------------
  635. // Patch all possible installed products.
  637. UINT WINAPI MsiApplyPatchA(
  638. LPCSTR      szPatchPackage,   // location of patch package
  639. LPCSTR      szInstallPackage, // location of package for install to patch <optional>
  640. INSTALLTYPE   eInstallType,     // type of install to patch
  641. LPCSTR      szCommandLine);   // command line <property settings>
  642. UINT WINAPI MsiApplyPatchW(
  643. LPCWSTR      szPatchPackage,   // location of patch package
  644. LPCWSTR      szInstallPackage, // location of package for install to patch <optional>
  645. INSTALLTYPE   eInstallType,     // type of install to patch
  646. LPCWSTR      szCommandLine);   // command line <property settings>
  647. #ifdef UNICODE
  648. #define MsiApplyPatch  MsiApplyPatchW
  649. #else
  650. #define MsiApplyPatch  MsiApplyPatchA
  651. #endif // !UNICODE
  653. // Return patch info
  655. UINT WINAPI MsiGetPatchInfoA(
  656. LPCSTR   szPatch,        // patch code
  657. LPCSTR   szAttribute,    // attribute name, case-sensitive
  658. LPSTR    lpValueBuf,     // returned value, NULL if not desired
  659. DWORD      *pcchValueBuf); // in/out buffer character count
  660. UINT WINAPI MsiGetPatchInfoW(
  661. LPCWSTR   szPatch,        // patch code
  662. LPCWSTR   szAttribute,    // attribute name, case-sensitive
  663. LPWSTR    lpValueBuf,     // returned value, NULL if not desired
  664. DWORD      *pcchValueBuf); // in/out buffer character count
  665. #ifdef UNICODE
  666. #define MsiGetPatchInfo  MsiGetPatchInfoW
  667. #else
  668. #define MsiGetPatchInfo  MsiGetPatchInfoA
  669. #endif // !UNICODE
  671. // Enumerate all patches for a product
  673. UINT WINAPI MsiEnumPatchesA(
  674. LPCSTR szProduct,
  675. DWORD    iPatchIndex,
  676. LPSTR  lpPatchBuf,
  677. LPSTR  lpTransformsBuf,
  678. DWORD    *pcchTransformsBuf);
  679. UINT WINAPI MsiEnumPatchesW(
  680. LPCWSTR szProduct,
  681. DWORD    iPatchIndex,
  682. LPWSTR  lpPatchBuf,
  683. LPWSTR  lpTransformsBuf,
  684. DWORD    *pcchTransformsBuf);
  685. #ifdef UNICODE
  686. #define MsiEnumPatches  MsiEnumPatchesW
  687. #else
  688. #define MsiEnumPatches  MsiEnumPatchesA
  689. #endif // !UNICODE
  691. // --------------------------------------------------------------------------
  692. // Functions to query and configure a feature within a product.
  693. // --------------------------------------------------------------------------
  695. // Return the installed state for a product feature
  697. INSTALLSTATE WINAPI MsiQueryFeatureStateA(
  698. LPCSTR  szProduct,
  699. LPCSTR  szFeature);
  700. INSTALLSTATE WINAPI MsiQueryFeatureStateW(
  701. LPCWSTR  szProduct,
  702. LPCWSTR  szFeature);
  703. #ifdef UNICODE
  704. #define MsiQueryFeatureState  MsiQueryFeatureStateW
  705. #else
  706. #define MsiQueryFeatureState  MsiQueryFeatureStateA
  707. #endif // !UNICODE
  709. // Indicate intent to use a product feature, increments usage count
  710. // Prompts for CD if not loaded, does not install feature
  712. INSTALLSTATE WINAPI MsiUseFeatureA(
  713. LPCSTR  szProduct,
  714. LPCSTR  szFeature);
  715. INSTALLSTATE WINAPI MsiUseFeatureW(
  716. LPCWSTR  szProduct,
  717. LPCWSTR  szFeature);
  718. #ifdef UNICODE
  719. #define MsiUseFeature  MsiUseFeatureW
  720. #else
  721. #define MsiUseFeature  MsiUseFeatureA
  722. #endif // !UNICODE
  724. // Indicate intent to use a product feature, increments usage count
  725. // Prompts for CD if not loaded, does not install feature
  726. // Allows for bypassing component detection where performance is critical
  728. INSTALLSTATE WINAPI MsiUseFeatureExA(
  729. LPCSTR  szProduct,          // product code
  730. LPCSTR  szFeature,          // feature ID
  731. DWORD     dwInstallMode,      // INSTALLMODE_NODETECTION, else 0
  732. DWORD     dwReserved);        // reserved, must be 0
  733. INSTALLSTATE WINAPI MsiUseFeatureExW(
  734. LPCWSTR  szProduct,          // product code
  735. LPCWSTR  szFeature,          // feature ID
  736. DWORD     dwInstallMode,      // INSTALLMODE_NODETECTION, else 0
  737. DWORD     dwReserved);        // reserved, must be 0
  738. #ifdef UNICODE
  739. #define MsiUseFeatureEx  MsiUseFeatureExW
  740. #else
  741. #define MsiUseFeatureEx  MsiUseFeatureExA
  742. #endif // !UNICODE
  744. // Return the usage metrics for a product feature
  746. UINT WINAPI MsiGetFeatureUsageA(
  747. LPCSTR      szProduct,        // product code
  748. LPCSTR      szFeature,        // feature ID
  749. DWORD        *pdwUseCount,     // returned use count
  750. WORD         *pwDateUsed);     // last date used (DOS date format)
  751. UINT WINAPI MsiGetFeatureUsageW(
  752. LPCWSTR      szProduct,        // product code
  753. LPCWSTR      szFeature,        // feature ID
  754. DWORD        *pdwUseCount,     // returned use count
  755. WORD         *pwDateUsed);     // last date used (DOS date format)
  756. #ifdef UNICODE
  757. #define MsiGetFeatureUsage  MsiGetFeatureUsageW
  758. #else
  759. #define MsiGetFeatureUsage  MsiGetFeatureUsageA
  760. #endif // !UNICODE
  762. // Force the installed state for a product feature
  764. UINT WINAPI MsiConfigureFeatureA(
  765. LPCSTR  szProduct,
  766. LPCSTR  szFeature,
  767. INSTALLSTATE eInstallState);   // local/source/default/absent/lock/uncache
  768. UINT WINAPI MsiConfigureFeatureW(
  769. LPCWSTR  szProduct,
  770. LPCWSTR  szFeature,
  771. INSTALLSTATE eInstallState);   // local/source/default/absent/lock/uncache
  772. #ifdef UNICODE
  773. #define MsiConfigureFeature  MsiConfigureFeatureW
  774. #else
  775. #define MsiConfigureFeature  MsiConfigureFeatureA
  776. #endif // !UNICODE
  779. // Reinstall feature, used to validate or correct problems
  781. UINT WINAPI MsiReinstallFeatureA(
  782. LPCSTR      szProduct,        // product code
  783. LPCSTR      szFeature,        // feature ID, NULL for entire product
  784. DWORD         dwReinstallMode); // one or more REINSTALLMODE modes
  785. UINT WINAPI MsiReinstallFeatureW(
  786. LPCWSTR      szProduct,        // product code
  787. LPCWSTR      szFeature,        // feature ID, NULL for entire product
  788. DWORD         dwReinstallMode); // one or more REINSTALLMODE modes
  789. #ifdef UNICODE
  790. #define MsiReinstallFeature  MsiReinstallFeatureW
  791. #else
  792. #define MsiReinstallFeature  MsiReinstallFeatureA
  793. #endif // !UNICODE
  795. // --------------------------------------------------------------------------
  796. // Functions to return a path to a particular component.
  797. // The state of the feature being used should have been checked previously.
  798. // --------------------------------------------------------------------------
  800. // Return full component path, performing any necessary installation
  801. // calls MsiQueryFeatureState to detect that all components are installed
  802. // then calls MsiConfigureFeature if any of its components are uninstalled
  803. // then calls MsiLocateComponent to obtain the path the its key file
  805. UINT WINAPI MsiProvideComponentA(
  806. LPCSTR     szProduct,    // product code in case install required
  807. LPCSTR     szFeature,    // feature ID in case install required
  808. LPCSTR     szComponent,  // component ID
  809. DWORD        dwInstallMode,// either of type INSTALLMODE or a combination of the REINSTALLMODE flags
  810. LPSTR      lpPathBuf,    // returned path, NULL if not desired
  811. DWORD       *pcchPathBuf);// in/out buffer character count
  812. UINT WINAPI MsiProvideComponentW(
  813. LPCWSTR     szProduct,    // product code in case install required
  814. LPCWSTR     szFeature,    // feature ID in case install required
  815. LPCWSTR     szComponent,  // component ID
  816. DWORD        dwInstallMode,// either of type INSTALLMODE or a combination of the REINSTALLMODE flags
  817. LPWSTR      lpPathBuf,    // returned path, NULL if not desired
  818. DWORD       *pcchPathBuf);// in/out buffer character count
  819. #ifdef UNICODE
  820. #define MsiProvideComponent  MsiProvideComponentW
  821. #else
  822. #define MsiProvideComponent  MsiProvideComponentA
  823. #endif // !UNICODE
  825. // Return full component path for a qualified component, performing any necessary installation. 
  826. // Prompts for source if necessary and increments the usage count for the feature.
  828. UINT WINAPI MsiProvideQualifiedComponentA(
  829. LPCSTR     szCategory,   // component category ID
  830. LPCSTR     szQualifier,  // specifies which component to access
  831. DWORD        dwInstallMode,// either of type INSTALLMODE or a combination of the REINSTALLMODE flags
  832. LPSTR      lpPathBuf,    // returned path, NULL if not desired
  833. DWORD       *pcchPathBuf); // in/out buffer character count
  834. UINT WINAPI MsiProvideQualifiedComponentW(
  835. LPCWSTR     szCategory,   // component category ID
  836. LPCWSTR     szQualifier,  // specifies which component to access
  837. DWORD        dwInstallMode,// either of type INSTALLMODE or a combination of the REINSTALLMODE flags
  838. LPWSTR      lpPathBuf,    // returned path, NULL if not desired
  839. DWORD       *pcchPathBuf); // in/out buffer character count
  840. #ifdef UNICODE
  841. #define MsiProvideQualifiedComponent  MsiProvideQualifiedComponentW
  842. #else
  843. #define MsiProvideQualifiedComponent  MsiProvideQualifiedComponentA
  844. #endif // !UNICODE
  846. // Return full component path for a qualified component, performing any necessary installation. 
  847. // Prompts for source if necessary and increments the usage count for the feature.
  848. // The szProduct parameter specifies the product to match that has published the qualified
  849. // component. If null, this API works the same as MsiProvideQualifiedComponent. 
  851. UINT WINAPI MsiProvideQualifiedComponentExA(
  852. LPCSTR     szCategory,   // component category ID
  853. LPCSTR     szQualifier,  // specifies which component to access
  854. DWORD        dwInstallMode,// either of type INSTALLMODE or a combination of the REINSTALLMODE flags
  855. LPCSTR     szProduct,    // the product code 
  856. DWORD        dwUnused1,    // not used, must be zero
  857. DWORD        dwUnused2,    // not used, must be zero
  858. LPSTR      lpPathBuf,    // returned path, NULL if not desired
  859. DWORD       *pcchPathBuf); // in/out buffer character count
  860. UINT WINAPI MsiProvideQualifiedComponentExW(
  861. LPCWSTR     szCategory,   // component category ID
  862. LPCWSTR     szQualifier,  // specifies which component to access
  863. DWORD        dwInstallMode,// either of type INSTALLMODE or a combination of the REINSTALLMODE flags
  864. LPCWSTR     szProduct,    // the product code 
  865. DWORD        dwUnused1,    // not used, must be zero
  866. DWORD        dwUnused2,    // not used, must be zero
  867. LPWSTR      lpPathBuf,    // returned path, NULL if not desired
  868. DWORD       *pcchPathBuf); // in/out buffer character count
  869. #ifdef UNICODE
  870. #define MsiProvideQualifiedComponentEx  MsiProvideQualifiedComponentExW
  871. #else
  872. #define MsiProvideQualifiedComponentEx  MsiProvideQualifiedComponentExA
  873. #endif // !UNICODE
  875. // Return full path to an installed component
  877. INSTALLSTATE WINAPI MsiGetComponentPathA(
  878. LPCSTR   szProduct,   // product code for client product
  879. LPCSTR   szComponent, // component Id, string GUID
  880. LPSTR    lpPathBuf,   // returned path
  881. DWORD     *pcchBuf);    // in/out buffer character count
  882. INSTALLSTATE WINAPI MsiGetComponentPathW(
  883. LPCWSTR   szProduct,   // product code for client product
  884. LPCWSTR   szComponent, // component Id, string GUID
  885. LPWSTR    lpPathBuf,   // returned path
  886. DWORD     *pcchBuf);    // in/out buffer character count
  887. #ifdef UNICODE
  888. #define MsiGetComponentPath  MsiGetComponentPathW
  889. #else
  890. #define MsiGetComponentPath  MsiGetComponentPathA
  891. #endif // !UNICODE
  893. #if (_WIN32_MSI >= 150)
  895. #define MSIASSEMBLYINFO_NETASSEMBLY   0 // Net assemblies
  896. #define MSIASSEMBLYINFO_WIN32ASSEMBLY 1 // Win32 assemblies
  898. // Return full component path for an assembly installed via the WI, performing any necessary installation. 
  899. // Prompts for source if necessary and increments the usage count for the feature.
  900. // The szAssemblyName parameter specifies the stringized assembly name. 
  901. // The szAppContext is the full path to the .cfg file or the app exe to which the assembly being requested 
  902. // has been privatised to, which is null for global assemblies
  904. UINT WINAPI MsiProvideAssemblyA(
  905. LPCSTR    szAssemblyName,   // stringized assembly name
  906. LPCSTR    szAppContext,  // specifies the full path to the parent asm's .cfg file, null for global assemblies
  907. DWORD       dwInstallMode,// either of type INSTALLMODE or a combination of the REINSTALLMODE flags
  908. DWORD       dwAssemblyInfo,  // assembly info, including assembly type
  909. LPSTR     lpPathBuf,    // returned path, NULL if not desired
  910. DWORD       *pcchPathBuf); // in/out buffer character count
  911. UINT WINAPI MsiProvideAssemblyW(
  912. LPCWSTR    szAssemblyName,   // stringized assembly name
  913. LPCWSTR    szAppContext,  // specifies the full path to the parent asm's .cfg file, null for global assemblies
  914. DWORD       dwInstallMode,// either of type INSTALLMODE or a combination of the REINSTALLMODE flags
  915. DWORD       dwAssemblyInfo,  // assembly info, including assembly type
  916. LPWSTR     lpPathBuf,    // returned path, NULL if not desired
  917. DWORD       *pcchPathBuf); // in/out buffer character count
  918. #ifdef UNICODE
  919. #define MsiProvideAssembly  MsiProvideAssemblyW
  920. #else
  921. #define MsiProvideAssembly  MsiProvideAssemblyA
  922. #endif // !UNICODE
  924. #endif //(_WIN32_MSI >=  150)
  927. // --------------------------------------------------------------------------
  928. // Functions to iterate registered products, features, and components.
  929. // As with reg keys, they accept a 0-based index into the enumeration.
  930. // --------------------------------------------------------------------------
  932. // Enumerate the registered products, either installed or advertised
  934. UINT WINAPI MsiEnumProductsA(
  935. DWORD     iProductIndex,    // 0-based index into registered products
  936. LPSTR   lpProductBuf);    // buffer of char count: 39 (size of string GUID)
  937. UINT WINAPI MsiEnumProductsW(
  938. DWORD     iProductIndex,    // 0-based index into registered products
  939. LPWSTR   lpProductBuf);    // buffer of char count: 39 (size of string GUID)
  940. #ifdef UNICODE
  941. #define MsiEnumProducts  MsiEnumProductsW
  942. #else
  943. #define MsiEnumProducts  MsiEnumProductsA
  944. #endif // !UNICODE
  946. #if (_WIN32_MSI >=  110)
  948. // Enumerate products with given upgrade code
  950. UINT WINAPI MsiEnumRelatedProductsA(
  951. LPCSTR  lpUpgradeCode,    // upgrade code of products to enumerate
  952. DWORD     dwReserved,       // reserved, must be 0
  953. DWORD     iProductIndex,    // 0-based index into registered products
  954. LPSTR   lpProductBuf);    // buffer of char count: 39 (size of string GUID)
  955. UINT WINAPI MsiEnumRelatedProductsW(
  956. LPCWSTR  lpUpgradeCode,    // upgrade code of products to enumerate
  957. DWORD     dwReserved,       // reserved, must be 0
  958. DWORD     iProductIndex,    // 0-based index into registered products
  959. LPWSTR   lpProductBuf);    // buffer of char count: 39 (size of string GUID)
  960. #ifdef UNICODE
  961. #define MsiEnumRelatedProducts  MsiEnumRelatedProductsW
  962. #else
  963. #define MsiEnumRelatedProducts  MsiEnumRelatedProductsA
  964. #endif // !UNICODE
  966. #endif //(_WIN32_MSI >=  110)
  968. // Enumerate the advertised features for a given product.
  969. // If parent is not required, supplying NULL will improve performance.
  971. UINT WINAPI MsiEnumFeaturesA(
  972. LPCSTR  szProduct,
  973. DWORD     iFeatureIndex,  // 0-based index into published features
  974. LPSTR   lpFeatureBuf,   // feature name buffer,   size=MAX_FEATURE_CHARS+1
  975. LPSTR   lpParentBuf);   // parent feature buffer, size=MAX_FEATURE_CHARS+1
  976. UINT WINAPI MsiEnumFeaturesW(
  977. LPCWSTR  szProduct,
  978. DWORD     iFeatureIndex,  // 0-based index into published features
  979. LPWSTR   lpFeatureBuf,   // feature name buffer,   size=MAX_FEATURE_CHARS+1
  980. LPWSTR   lpParentBuf);   // parent feature buffer, size=MAX_FEATURE_CHARS+1
  981. #ifdef UNICODE
  982. #define MsiEnumFeatures  MsiEnumFeaturesW
  983. #else
  984. #define MsiEnumFeatures  MsiEnumFeaturesA
  985. #endif // !UNICODE
  987. // Enumerate the installed components for all products
  989. UINT WINAPI MsiEnumComponentsA(
  990. DWORD    iComponentIndex,  // 0-based index into installed components
  991. LPSTR   lpComponentBuf);  // buffer of char count: 39 (size of string GUID)
  992. UINT WINAPI MsiEnumComponentsW(
  993. DWORD    iComponentIndex,  // 0-based index into installed components
  994. LPWSTR   lpComponentBuf);  // buffer of char count: 39 (size of string GUID)
  995. #ifdef UNICODE
  996. #define MsiEnumComponents  MsiEnumComponentsW
  997. #else
  998. #define MsiEnumComponents  MsiEnumComponentsA
  999. #endif // !UNICODE
  1001. // Enumerate the client products for a component
  1003. UINT WINAPI MsiEnumClientsA(
  1004. LPCSTR  szComponent,
  1005. DWORD     iProductIndex,    // 0-based index into client products
  1006. LPSTR   lpProductBuf);    // buffer of char count: 39 (size of string GUID)
  1007. UINT WINAPI MsiEnumClientsW(
  1008. LPCWSTR  szComponent,
  1009. DWORD     iProductIndex,    // 0-based index into client products
  1010. LPWSTR   lpProductBuf);    // buffer of char count: 39 (size of string GUID)
  1011. #ifdef UNICODE
  1012. #define MsiEnumClients  MsiEnumClientsW
  1013. #else
  1014. #define MsiEnumClients  MsiEnumClientsA
  1015. #endif // !UNICODE
  1017. // Enumerate the qualifiers for an advertised component.
  1019. UINT WINAPI MsiEnumComponentQualifiersA(
  1020. LPCSTR   szComponent,         // generic component ID that is qualified
  1021. DWORD     iIndex,            // 0-based index into qualifiers
  1022. LPSTR    lpQualifierBuf,      // qualifier buffer
  1023. DWORD     *pcchQualifierBuf,   // in/out qualifier buffer character count
  1024. LPSTR    lpApplicationDataBuf,    // description buffer
  1025. DWORD     *pcchApplicationDataBuf); // in/out description buffer character count
  1026. UINT WINAPI MsiEnumComponentQualifiersW(
  1027. LPCWSTR   szComponent,         // generic component ID that is qualified
  1028. DWORD     iIndex,            // 0-based index into qualifiers
  1029. LPWSTR    lpQualifierBuf,      // qualifier buffer
  1030. DWORD     *pcchQualifierBuf,   // in/out qualifier buffer character count
  1031. LPWSTR    lpApplicationDataBuf,    // description buffer
  1032. DWORD     *pcchApplicationDataBuf); // in/out description buffer character count
  1033. #ifdef UNICODE
  1034. #define MsiEnumComponentQualifiers  MsiEnumComponentQualifiersW
  1035. #else
  1036. #define MsiEnumComponentQualifiers  MsiEnumComponentQualifiersA
  1037. #endif // !UNICODE
  1039. // --------------------------------------------------------------------------
  1040. // Functions to obtain product or package information.
  1041. // --------------------------------------------------------------------------
  1043. // Open the installation for a product to obtain detailed information
  1045. UINT WINAPI MsiOpenProductA(
  1046. LPCSTR   szProduct,    // product code
  1047. MSIHANDLE  *hProduct);   // returned product handle, must be closed
  1048. UINT WINAPI MsiOpenProductW(
  1049. LPCWSTR   szProduct,    // product code
  1050. MSIHANDLE  *hProduct);   // returned product handle, must be closed
  1051. #ifdef UNICODE
  1052. #define MsiOpenProduct  MsiOpenProductW
  1053. #else
  1054. #define MsiOpenProduct  MsiOpenProductA
  1055. #endif // !UNICODE
  1057. // Open a product package in order to access product properties
  1059. UINT WINAPI MsiOpenPackageA(
  1060. LPCSTR    szPackagePath,     // path to package, or database handle: #nnnn
  1061. MSIHANDLE  *hProduct);         // returned product handle, must be closed
  1062. UINT WINAPI MsiOpenPackageW(
  1063. LPCWSTR    szPackagePath,     // path to package, or database handle: #nnnn
  1064. MSIHANDLE  *hProduct);         // returned product handle, must be closed
  1065. #ifdef UNICODE
  1066. #define MsiOpenPackage  MsiOpenPackageW
  1067. #else
  1068. #define MsiOpenPackage  MsiOpenPackageA
  1069. #endif // !UNICODE
  1071. #if (_WIN32_MSI >=  150)
  1073. // Open a product package in order to access product properties
  1074. // Option to create a "safe" engine that does not look at machine state
  1075. //  and does not allow for modification of machine state
  1077. UINT WINAPI MsiOpenPackageExA(
  1078. LPCSTR   szPackagePath, // path to package, or database handle: #nnnn
  1079. DWORD      dwOptions,     // options flags to indicate whether or not to ignore machine state
  1080. MSIHANDLE *hProduct);     // returned product handle, must be closed
  1081. UINT WINAPI MsiOpenPackageExW(
  1082. LPCWSTR   szPackagePath, // path to package, or database handle: #nnnn
  1083. DWORD      dwOptions,     // options flags to indicate whether or not to ignore machine state
  1084. MSIHANDLE *hProduct);     // returned product handle, must be closed
  1085. #ifdef UNICODE
  1086. #define MsiOpenPackageEx  MsiOpenPackageExW
  1087. #else
  1088. #define MsiOpenPackageEx  MsiOpenPackageExA
  1089. #endif // !UNICODE
  1091. #endif //(_WIN32_MSI >= 150)
  1093. // Provide the value for an installation property.
  1095. UINT WINAPI MsiGetProductPropertyA(
  1096. MSIHANDLE   hProduct,       // product handle obtained from MsiOpenProduct
  1097. LPCSTR    szProperty,     // property name, case-sensitive
  1098. LPSTR     lpValueBuf,     // returned value, NULL if not desired
  1099. DWORD      *pcchValueBuf); // in/out buffer character count
  1100. UINT WINAPI MsiGetProductPropertyW(
  1101. MSIHANDLE   hProduct,       // product handle obtained from MsiOpenProduct
  1102. LPCWSTR    szProperty,     // property name, case-sensitive
  1103. LPWSTR     lpValueBuf,     // returned value, NULL if not desired
  1104. DWORD      *pcchValueBuf); // in/out buffer character count
  1105. #ifdef UNICODE
  1106. #define MsiGetProductProperty  MsiGetProductPropertyW
  1107. #else
  1108. #define MsiGetProductProperty  MsiGetProductPropertyA
  1109. #endif // !UNICODE
  1112. // Determine whether a file is a package
  1113. // Returns ERROR_SUCCESS if file is a package.
  1115. UINT WINAPI MsiVerifyPackageA(
  1116. LPCSTR      szPackagePath);   // location of package
  1117. UINT WINAPI MsiVerifyPackageW(
  1118. LPCWSTR      szPackagePath);   // location of package
  1119. #ifdef UNICODE
  1120. #define MsiVerifyPackage  MsiVerifyPackageW
  1121. #else
  1122. #define MsiVerifyPackage  MsiVerifyPackageA
  1123. #endif // !UNICODE
  1126. // Provide descriptive information for product feature: title and description.
  1127. // Returns the install level for the feature, or -1 if feature is unknown.
  1128. //   0 = feature is not available on this machine
  1129. //   1 = highest priority, feature installed if parent is installed
  1130. //  >1 = decreasing priority, feature installation based on InstallLevel property
  1132. UINT WINAPI MsiGetFeatureInfoA(
  1133. MSIHANDLE   hProduct,       // product handle obtained from MsiOpenProduct
  1134. LPCSTR    szFeature,      // feature name
  1135. DWORD      *lpAttributes,  // attribute flags for the feature, using INSTALLFEATUREATTRIBUTE
  1136. LPSTR     lpTitleBuf,     // returned localized name, NULL if not desired
  1137. DWORD      *pcchTitleBuf,  // in/out buffer character count
  1138. LPSTR     lpHelpBuf,      // returned description, NULL if not desired
  1139. DWORD      *pcchHelpBuf);  // in/out buffer character count
  1140. UINT WINAPI MsiGetFeatureInfoW(
  1141. MSIHANDLE   hProduct,       // product handle obtained from MsiOpenProduct
  1142. LPCWSTR    szFeature,      // feature name
  1143. DWORD      *lpAttributes,  // attribute flags for the feature, using INSTALLFEATUREATTRIBUTE
  1144. LPWSTR     lpTitleBuf,     // returned localized name, NULL if not desired
  1145. DWORD      *pcchTitleBuf,  // in/out buffer character count
  1146. LPWSTR     lpHelpBuf,      // returned description, NULL if not desired
  1147. DWORD      *pcchHelpBuf);  // in/out buffer character count
  1148. #ifdef UNICODE
  1149. #define MsiGetFeatureInfo  MsiGetFeatureInfoW
  1150. #else
  1151. #define MsiGetFeatureInfo  MsiGetFeatureInfoA
  1152. #endif // !UNICODE
  1154. // --------------------------------------------------------------------------
  1155. // Functions to access or install missing components and files.
  1156. // These should be used as a last resort.
  1157. // --------------------------------------------------------------------------
  1159. // Install a component unexpectedly missing, provided only for error recovery
  1160. // This would typically occur due to failue to establish feature availability
  1161. // The product feature having the smallest incremental cost is installed
  1163. UINT WINAPI MsiInstallMissingComponentA(
  1164. LPCSTR      szProduct,        // product code
  1165. LPCSTR      szComponent,      // component Id, string GUID
  1166. INSTALLSTATE eInstallState);  // local/source/default, absent invalid
  1167. UINT WINAPI MsiInstallMissingComponentW(
  1168. LPCWSTR      szProduct,        // product code
  1169. LPCWSTR      szComponent,      // component Id, string GUID
  1170. INSTALLSTATE eInstallState);  // local/source/default, absent invalid
  1171. #ifdef UNICODE
  1172. #define MsiInstallMissingComponent  MsiInstallMissingComponentW
  1173. #else
  1174. #define MsiInstallMissingComponent  MsiInstallMissingComponentA
  1175. #endif // !UNICODE
  1177. // Install a file unexpectedly missing, provided only for error recovery
  1178. // This would typically occur due to failue to establish feature availability
  1179. // The missing component is determined from the product's File table, then
  1180. // the product feature having the smallest incremental cost is installed
  1182. UINT WINAPI MsiInstallMissingFileA(
  1183. LPCSTR      szProduct,        // product code
  1184. LPCSTR      szFile);          // file name, without path
  1185. UINT WINAPI MsiInstallMissingFileW(
  1186. LPCWSTR      szProduct,        // product code
  1187. LPCWSTR      szFile);          // file name, without path
  1188. #ifdef UNICODE
  1189. #define MsiInstallMissingFile  MsiInstallMissingFileW
  1190. #else
  1191. #define MsiInstallMissingFile  MsiInstallMissingFileA
  1192. #endif // !UNICODE
  1194. // Return full path to an installed component without a product code
  1195. // This function attempts to determine the product using MsiGetProductCode
  1196. // but is not guaranteed to find the correct product for the caller.
  1197. // MsiGetComponentPath should always be called when possible.
  1199. INSTALLSTATE WINAPI MsiLocateComponentA(
  1200. LPCSTR szComponent,  // component Id, string GUID
  1201. LPSTR  lpPathBuf,    // returned path
  1202. DWORD   *pcchBuf);    // in/out buffer character count
  1203. INSTALLSTATE WINAPI MsiLocateComponentW(
  1204. LPCWSTR szComponent,  // component Id, string GUID
  1205. LPWSTR  lpPathBuf,    // returned path
  1206. DWORD   *pcchBuf);    // in/out buffer character count
  1207. #ifdef UNICODE
  1208. #define MsiLocateComponent  MsiLocateComponentW
  1209. #else
  1210. #define MsiLocateComponent  MsiLocateComponentA
  1211. #endif // !UNICODE
  1213. #if (_WIN32_MSI >=  110)
  1215. // --------------------------------------------------------------------------
  1216. // Functions used to manage the list of valid sources.
  1217. // --------------------------------------------------------------------------
  1219. // Opens the list of sources for the specified user's install of the product
  1220. // and removes all network sources from the list. A NULL or empty value for
  1221. // the user name indicates the per-machine install.
  1223. UINT WINAPI MsiSourceListClearAllA(
  1224. LPCSTR szProduct,          // product code
  1225. LPCSTR szUserName,         // user name or NULL/empty for per-machine
  1226. DWORD    dwReserved);        // reserved - must be 0
  1227. UINT WINAPI MsiSourceListClearAllW(
  1228. LPCWSTR szProduct,          // product code
  1229. LPCWSTR szUserName,         // user name or NULL/empty for per-machine
  1230. DWORD    dwReserved);        // reserved - must be 0
  1231. #ifdef UNICODE
  1232. #define MsiSourceListClearAll  MsiSourceListClearAllW
  1233. #else
  1234. #define MsiSourceListClearAll  MsiSourceListClearAllA
  1235. #endif // !UNICODE
  1237. // Opens the list of sources for the specified user's install of the product
  1238. // and adds the provided source as a new network source. A NULL or empty 
  1239. // value for the user name indicates the per-machine install.
  1241. UINT WINAPI MsiSourceListAddSourceA(
  1242. LPCSTR szProduct,          // product code
  1243. LPCSTR szUserName,         // user name or NULL/empty for per-machine
  1244. DWORD    dwReserved,         // reserved - must be 0
  1245. LPCSTR szSource);          // new source
  1246. UINT WINAPI MsiSourceListAddSourceW(
  1247. LPCWSTR szProduct,          // product code
  1248. LPCWSTR szUserName,         // user name or NULL/empty for per-machine
  1249. DWORD    dwReserved,         // reserved - must be 0
  1250. LPCWSTR szSource);          // new source
  1251. #ifdef UNICODE
  1252. #define MsiSourceListAddSource  MsiSourceListAddSourceW
  1253. #else
  1254. #define MsiSourceListAddSource  MsiSourceListAddSourceA
  1255. #endif // !UNICODE
  1257. // Forces the installer to reevaluate the list of sources the next time that
  1258. // the specified product needs a source.
  1260. UINT WINAPI MsiSourceListForceResolutionA(
  1261. LPCSTR szProduct,          // product code
  1262. LPCSTR szUserName,         // user name or NULL/empty for per-machine
  1263. DWORD    dwReserved);        // reserved - must be 0
  1264. UINT WINAPI MsiSourceListForceResolutionW(
  1265. LPCWSTR szProduct,          // product code
  1266. LPCWSTR szUserName,         // user name or NULL/empty for per-machine
  1267. DWORD    dwReserved);        // reserved - must be 0
  1268. #ifdef UNICODE
  1269. #define MsiSourceListForceResolution  MsiSourceListForceResolutionW
  1270. #else
  1271. #define MsiSourceListForceResolution  MsiSourceListForceResolutionA
  1272. #endif // !UNICODE
  1274. #endif //(_WIN32_MSI >=  110)
  1276. // --------------------------------------------------------------------------
  1277. // Utility functions
  1278. // --------------------------------------------------------------------------
  1280. // Give the version string and language for a specified file
  1282. UINT WINAPI MsiGetFileVersionA(
  1283. LPCSTR    szFilePath,       // path to the file
  1284. LPSTR     lpVersionBuf,     // returned version string
  1285. DWORD      *pcchVersionBuf,   // in/out buffer byte count
  1286. LPSTR     lpLangBuf,        // returned language string
  1287. DWORD       *pcchLangBuf);    // in/out buffer byte count
  1288. UINT WINAPI MsiGetFileVersionW(
  1289. LPCWSTR    szFilePath,       // path to the file
  1290. LPWSTR     lpVersionBuf,     // returned version string
  1291. DWORD      *pcchVersionBuf,   // in/out buffer byte count
  1292. LPWSTR     lpLangBuf,        // returned language string
  1293. DWORD       *pcchLangBuf);    // in/out buffer byte count
  1294. #ifdef UNICODE
  1295. #define MsiGetFileVersion  MsiGetFileVersionW
  1296. #else
  1297. #define MsiGetFileVersion  MsiGetFileVersionA
  1298. #endif // !UNICODE
  1301. #if (_WIN32_MSI >=  150)
  1303. UINT WINAPI MsiGetFileHashA(
  1304. LPCSTR         szFilePath,  // path to the file
  1305. DWORD            dwOptions,   // options
  1306. PMSIFILEHASHINFO pHash);      // returned file hash info
  1307. UINT WINAPI MsiGetFileHashW(
  1308. LPCWSTR         szFilePath,  // path to the file
  1309. DWORD            dwOptions,   // options
  1310. PMSIFILEHASHINFO pHash);      // returned file hash info
  1311. #ifdef UNICODE
  1312. #define MsiGetFileHash  MsiGetFileHashW
  1313. #else
  1314. #define MsiGetFileHash  MsiGetFileHashA
  1315. #endif // !UNICODE
  1317. #endif //(_WIN32_MSI >=  150)
  1319. #if (_WIN32_MSI >= 150)
  1320. #ifndef _MSI_NO_CRYPTO
  1322. HRESULT WINAPI MsiGetFileSignatureInformationA(
  1323. LPCSTR  szSignedObjectPath, // path to the signed object
  1324. DWORD            dwFlags,            // special extra error case flags
  1325. PCCERT_CONTEXT  *ppcCertContext,     // returned signer cert context
  1326. BYTE            *pbHashData,         // returned hash buffer, NULL if not desired
  1327. DWORD           *pcbHashData);       // in/out buffer byte count
  1328. HRESULT WINAPI MsiGetFileSignatureInformationW(
  1329. LPCWSTR  szSignedObjectPath, // path to the signed object
  1330. DWORD            dwFlags,            // special extra error case flags
  1331. PCCERT_CONTEXT  *ppcCertContext,     // returned signer cert context
  1332. BYTE            *pbHashData,         // returned hash buffer, NULL if not desired
  1333. DWORD           *pcbHashData);       // in/out buffer byte count
  1334. #ifdef UNICODE
  1335. #define MsiGetFileSignatureInformation  MsiGetFileSignatureInformationW
  1336. #else
  1337. #define MsiGetFileSignatureInformation  MsiGetFileSignatureInformationA
  1338. #endif // !UNICODE
  1340. // By default, when only requesting the certificate context, an invalid hash
  1341. // in the digital signature is not a fatal error.  Set this flag in the dwFlags
  1342. // parameter to make the TRUST_E_BAD_DIGEST error fatal.
  1343. #define MSI_INVALID_HASH_IS_FATAL 0x1
  1345. #endif// _MSI_NO_CRYPTO
  1346. #endif //(_WIN32_MSI >= 150)
  1348. #if (_WIN32_MSI >=  110)
  1350. // examine a shortcut, and retrieve its descriptor information 
  1351. // if available.
  1353. UINT WINAPI MsiGetShortcutTargetA(
  1354. LPCSTR    szShortcutPath,    // full file path for the shortcut
  1355. LPSTR     szProductCode,     // returned product code   - GUID
  1356. LPSTR     szFeatureId,       // returned Feature Id.
  1357. LPSTR     szComponentCode);  // returned component code - GUID
  1358. UINT WINAPI MsiGetShortcutTargetW(
  1359. LPCWSTR    szShortcutPath,    // full file path for the shortcut
  1360. LPWSTR     szProductCode,     // returned product code   - GUID
  1361. LPWSTR     szFeatureId,       // returned Feature Id.
  1362. LPWSTR     szComponentCode);  // returned component code - GUID
  1363. #ifdef UNICODE
  1364. #define MsiGetShortcutTarget  MsiGetShortcutTargetW
  1365. #else
  1366. #define MsiGetShortcutTarget  MsiGetShortcutTargetA
  1367. #endif // !UNICODE
  1369. #endif //(_WIN32_MSI >=  110)
  1371. #if (_WIN32_MSI >=  110)
  1373. // checks to see if a product is managed
  1374. // checks per-machine if called from system context, per-user if from
  1375. // user context
  1376. UINT WINAPI MsiIsProductElevatedA(
  1377. LPCSTR szProduct, // product code
  1378. BOOL *pfElevated);  // result   
  1379. // checks to see if a product is managed
  1380. // checks per-machine if called from system context, per-user if from
  1381. // user context
  1382. UINT WINAPI MsiIsProductElevatedW(
  1383. LPCWSTR szProduct, // product code
  1384. BOOL *pfElevated);  // result   
  1385. #ifdef UNICODE
  1386. #define MsiIsProductElevated  MsiIsProductElevatedW
  1387. #else
  1388. #define MsiIsProductElevated  MsiIsProductElevatedA
  1389. #endif // !UNICODE
  1391. #endif //(_WIN32_MSI >=  110)
  1394. // --------------------------------------------------------------------------
  1395. // Internal state migration APIs.
  1396. // --------------------------------------------------------------------------
  1399. #ifdef __cplusplus
  1400. }
  1401. #endif
  1403. // --------------------------------------------------------------------------
  1404. // Error codes for installer access functions - until merged to winerr.h
  1405. // --------------------------------------------------------------------------
  1407. #ifndef ERROR_INSTALL_FAILURE
  1408. #define ERROR_INSTALL_USEREXIT      1602L  // User cancel installation.
  1409. #define ERROR_INSTALL_FAILURE       1603L  // Fatal error during installation.
  1410. #define ERROR_INSTALL_SUSPEND       1604L  // Installation suspended, incomplete.
  1411. // LOCALIZE BEGIN:
  1412. #define ERROR_UNKNOWN_PRODUCT       1605L  // This action is only valid for products that are currently installed.
  1413. // LOCALIZE END
  1414. #define ERROR_UNKNOWN_FEATURE       1606L  // Feature ID not registered.
  1415. #define ERROR_UNKNOWN_COMPONENT     1607L  // Component ID not registered.
  1416. #define ERROR_UNKNOWN_PROPERTY      1608L  // Unknown property.
  1417. #define ERROR_INVALID_HANDLE_STATE  1609L  // Handle is in an invalid state.
  1418. // LOCALIZE BEGIN:
  1419. #define ERROR_BAD_CONFIGURATION     1610L  // The configuration data for this product is corrupt.  Contact your support personnel.
  1420. // LOCALIZE END:
  1421. #define ERROR_INDEX_ABSENT          1611L  // Component qualifier not present.
  1422. // LOCALIZE BEGIN:
  1423. #define ERROR_INSTALL_SOURCE_ABSENT 1612L  // The installation source for this product is not available.  Verify that the source exists and that you can access it.
  1424. // LOCALIZE END
  1425. #define ERROR_PRODUCT_UNINSTALLED   1614L  // Product is uninstalled.
  1426. #define ERROR_BAD_QUERY_SYNTAX      1615L  // SQL query syntax invalid or unsupported.
  1427. #define ERROR_INVALID_FIELD         1616L  // Record field does not exist.
  1428. #endif
  1430. // LOCALIZE BEGIN:
  1431. #ifndef ERROR_INSTALL_SERVICE_FAILURE
  1432. #define ERROR_INSTALL_SERVICE_FAILURE      1601L // The Windows Installer Service could not be accessed. This can occur if you are running Windows in safe mode, or if the Windows Installer is not correctly installed. Contact your support personnel for assistance.
  1433. #define ERROR_INSTALL_PACKAGE_VERSION      1613L // This installation package cannot be installed by the Windows Installer service.  You must install a Windows service pack that contains a newer version of the Windows Installer service.
  1434. #define ERROR_INSTALL_ALREADY_RUNNING      1618L // Another installation is already in progress.  Complete that installation before proceeding with this install.
  1435. #define ERROR_INSTALL_PACKAGE_OPEN_FAILED  1619L // This installation package could not be opened.  Verify that the package exists and that you can access it, or contact the application vendor to verify that this is a valid Windows Installer package.
  1436. #define ERROR_INSTALL_PACKAGE_INVALID      1620L // This installation package could not be opened.  Contact the application vendor to verify that this is a valid Windows Installer package.
  1437. #define ERROR_INSTALL_UI_FAILURE           1621L // There was an error starting the Windows Installer service user interface.  Contact your support personnel.
  1438. #define ERROR_INSTALL_LOG_FAILURE          1622L // Error opening installation log file.  Verify that the specified log file location exists and is writable.
  1439. #define ERROR_INSTALL_LANGUAGE_UNSUPPORTED 1623L // This language of this installation package is not supported by your system.
  1440. #define ERROR_INSTALL_PACKAGE_REJECTED     1625L // The system administrator has set policies to prevent this installation.
  1441. // LOCALIZE END
  1443. #define ERROR_FUNCTION_NOT_CALLED          1626L // Function could not be executed.
  1444. #define ERROR_FUNCTION_FAILED              1627L // Function failed during execution.
  1445. #define ERROR_INVALID_TABLE                1628L // Invalid or unknown table specified.
  1446. #define ERROR_DATATYPE_MISMATCH            1629L // Data supplied is of wrong type.
  1447. #define ERROR_UNSUPPORTED_TYPE             1630L // Data of this type is not supported.
  1448. // LOCALIZE BEGIN:
  1449. #define ERROR_CREATE_FAILED                1631L // The Windows Installer service failed to start.  Contact your support personnel.
  1450. // LOCALIZE END:
  1451. #endif
  1453. // LOCALIZE BEGIN:
  1454. #ifndef ERROR_INSTALL_TEMP_UNWRITABLE      
  1455. #define ERROR_INSTALL_TEMP_UNWRITABLE      1632L // The Temp folder is on a drive that is full or is inaccessible. Free up space on the drive or verify that you have write permission on the Temp folder.
  1456. #endif
  1458. #ifndef ERROR_INSTALL_PLATFORM_UNSUPPORTED
  1459. #define ERROR_INSTALL_PLATFORM_UNSUPPORTED 1633L // This installation package is not supported by this processor type. Contact your product vendor.
  1460. #endif
  1461. // LOCALIZE END
  1463. #ifndef ERROR_INSTALL_NOTUSED
  1464. #define ERROR_INSTALL_NOTUSED              1634L // Component not used on this machine
  1465. #endif
  1467. // LOCALIZE BEGIN:
  1468. #ifndef ERROR_INSTALL_TRANSFORM_FAILURE
  1469. #define ERROR_INSTALL_TRANSFORM_FAILURE     1624L // Error applying transforms.  Verify that the specified transform paths are valid.
  1470. #endif
  1472. #ifndef ERROR_PATCH_PACKAGE_OPEN_FAILED
  1473. #define ERROR_PATCH_PACKAGE_OPEN_FAILED    1635L // This patch package could not be opened.  Verify that the patch package exists and that you can access it, or contact the application vendor to verify that this is a valid Windows Installer patch package.
  1474. #define ERROR_PATCH_PACKAGE_INVALID        1636L // This patch package could not be opened.  Contact the application vendor to verify that this is a valid Windows Installer patch package.
  1475. #define ERROR_PATCH_PACKAGE_UNSUPPORTED    1637L // This patch package cannot be processed by the Windows Installer service.  You must install a Windows service pack that contains a newer version of the Windows Installer service.
  1476. #endif
  1478. #ifndef ERROR_PRODUCT_VERSION
  1479. #define ERROR_PRODUCT_VERSION              1638L // Another version of this product is already installed.  Installation of this version cannot continue.  To configure or remove the existing version of this product, use Add/Remove Programs on the Control Panel.
  1480. #endif
  1482. #ifndef ERROR_INVALID_COMMAND_LINE
  1483. #define ERROR_INVALID_COMMAND_LINE         1639L // Invalid command line argument.  Consult the Windows Installer SDK for detailed command line help.
  1484. #endif
  1486. // The following three error codes are not returned from MSI version 1.0
  1488. #ifndef ERROR_INSTALL_REMOTE_DISALLOWED
  1489. #define ERROR_INSTALL_REMOTE_DISALLOWED    1640L // Only administrators have permission to add, remove, or configure server software during a Terminal services remote session. If you want to install or configure software on the server, contact your network administrator.
  1490. #endif
  1492. // LOCALIZE END
  1494. #ifndef ERROR_SUCCESS_REBOOT_INITIATED
  1495. #define ERROR_SUCCESS_REBOOT_INITIATED     1641L // The requested operation completed successfully.  The system will be restarted so the changes can take effect.
  1496. #endif
  1498. // LOCALIZE BEGIN:
  1499. #ifndef ERROR_PATCH_TARGET_NOT_FOUND
  1500. #define ERROR_PATCH_TARGET_NOT_FOUND       1642L // The upgrade patch cannot be installed by the Windows Installer service because the program to be upgraded may be missing, or the upgrade patch may update a different version of the program. Verify that the program to be upgraded exists on your computer and that you have the correct upgrade patch.
  1501. #endif
  1502. // LOCALIZE END
  1504. // The following two error codes are not returned from MSI version 1.0, 1.1. or 1.2
  1506. // LOCALIZE BEGIN:
  1507. #ifndef ERROR_PATCH_PACKAGE_REJECTED
  1508. #define ERROR_PATCH_PACKAGE_REJECTED       1643L // The patch package is not permitted by software restriction policy.
  1509. #endif
  1511. #ifndef ERROR_INSTALL_TRANSFORM_REJECTED
  1512. #define ERROR_INSTALL_TRANSFORM_REJECTED   1644L // One or more customizations are not permitted by software restriction policy.
  1513. #endif
  1514. // LOCALIZE END
  1516. #endif // _MSI_H_