The MsiProcessAdvertiseScript function processes an advertise script file into the specified locations.

Syntax

C++UINT MsiProcessAdvertiseScript(
  __in  LPCTSTR szScriptFile,
  __in  LPCTSTR szIconFolder,
  __in  HKEY hRegData,
  __in  BOOL fShortcuts,
  __in  BOOL fRemoveItems
);

Parameters

szScriptFile [in]

The full path to a script file generated by MsiAdvertiseProduct or MsiAdvertiseProductEx.

szIconFolder [in]

An optional path to a folder in which advertised icon files and transform files are located. If this parameter is null, no icon or transform files are written.

hRegData [in]

A registry key under which registry data is to be written. If this parameter is null, the installer writes the registry data under the appropriate key, based on whether the advertisement is per-user or per-machine. If this parameter is non-null, the script will write the registry data under the specified registry key rather than the normal location. In this case, the application will not get advertised to the user.

fShortcuts [in]

TRUE if shortcuts should be created. If a special folder is returned by SHGetSpecialFolderLocation it will hold the shortcuts.

fRemoveItems [in]

TRUE if specified items are to be removed instead of created.

Return Value

Remarks

The process calling this function must be running under the LocalSystem account. To advertise an application for per-user installation to a targeted user, the thread that calls this function must impersonate the targeted user. If the thread calling this function is not impersonating a targeted user, the application is advertised to all users for installation with elevated privileges.

Requirements

Send comments about this topic to Microsoft

Build date: 8/13/2009