The MsiAdvertiseProduct function generates an advertise script or advertises a product to the computer. The MsiAdvertiseProduct function enables the installer to write to a script the registry and shortcut information used to assign or publish a product. The script can be written to be consistent with a specified platform by using MsiAdvertiseProductEx.

Syntax

C++UINT MsiAdvertiseProduct(
  __in  LPCTSTR szPackagePath,
  __in  LPCTSTR szScriptfilePath,
  __in  LPCTSTR szTransforms,
  __in  LANGID lgidLanguage
);

Parameters

szPackagePath [in]

The full path to the package of the product being advertised.

szScriptfilePath [in]

The full path to script file that will be created with the advertise information. To advertise the product locally to the computer, set ADVERTISEFLAGS_MACHINEASSIGN or ADVERTISEFLAGS_USERASSIGN.

Flag	Meaning
ADVERTISEFLAGS_MACHINEASSIGN 0	Set to advertise a per-machine installation of the product available to all users.
ADVERTISEFLAGS_USERASSIGN 1	Set to advertise a per-user installation of the product available to a particular user.

 

szTransforms [in]

A semicolon-delimited list of transforms to be applied. The list of transforms can be prefixed with the @ or | character to specify the secure caching of transforms. The @ prefix specifies secure-at-source transforms and the | prefix indicates secure full path transforms. For more information, see Secured Transforms. This parameter may be null.

lgidLanguage [in]

The installation language to use if the source supports multiple languages.

Return Value

Requirements

See Also

Multiple-Package Installations

Send comments about this topic to Microsoft

Build date: 8/13/2009