MsiAdvertiseProductA, fonction (msi.h)

Article
08/24/2023

La fonction MsiAdvertiseProduct génère un script de publicité ou publie un produit sur l’ordinateur. La fonction MsiAdvertiseProduct permet au programme d’installation d’écrire dans un script les informations de registre et de raccourci utilisées pour attribuer ou publier un produit. Le script peut être écrit pour être cohérent avec une plateforme spécifiée à l’aide de MsiAdvertiseProductEx.

Syntaxe

UINT MsiAdvertiseProductA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szScriptfilePath,
  [in] LPCSTR szTransforms,
  [in] LANGID lgidLanguage
);

Paramètres

[in] szPackagePath

Chemin d’accès complet au package du produit publié.

[in] szScriptfilePath

Chemin d’accès complet au fichier de script qui sera créé avec les informations de publication. Pour publier le produit localement sur l’ordinateur, définissez ADVERTISEFLAGS_MACHINEASSIGN ou ADVERTISEFLAGS_USERASSIGN.

Indicateur	Signification
ADVERTISEFLAGS_MACHINEASSIGN 0	Définissez pour publier une installation par ordinateur du produit disponible pour tous les utilisateurs.
ADVERTISEFLAGS_USERASSIGN 1	Définissez pour publier une installation par utilisateur du produit disponible pour un utilisateur particulier.

[in] szTransforms

Liste délimitée par des points-virgules de transformations à appliquer. La liste des transformations peut être précédée de @ ou | caractère pour spécifier la mise en cache sécurisée des transformations. Le préfixe @ spécifie les transformations sécurisées à la source et le | préfixe indique des transformations de chemin d’accès complet sécurisés. Pour plus d’informations, consultez Transformations sécurisées. Ce paramètre peut avoir la valeur null.

[in] lgidLanguage

Langue d’installation à utiliser si la source prend en charge plusieurs langues.

Valeur retournée

Valeur	Signification
ERROR_SUCCESS	La fonction s’est terminée avec succès.
Erreur liée à une action	Consultez Codes d’erreur.
Erreur d’initialisation	Une erreur d'initialisation s'est produite.
ERROR_CALL_NOT_IMPLEMENTED	Cette erreur est retournée si une tentative de génération d’un script de publication est effectuée sur une plateforme autre que Windows 2000 ou Windows XP. La publicité sur l’ordinateur local est prise en charge sur toutes les plateformes.

Notes

L’en-tête msi.h définit MsiAdvertiseProduct comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Spécifications


Client minimal pris en charge	Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows.
Plateforme cible	Windows
En-tête	msi.h
Bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

Installations à plusieurs packages

Partager via