MsiAdvertiseProductA, fonction (msi.h)

La fonction MsiAdvertiseProduct génère un script de publication 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 affecter ou publier un produit. Le script peut être écrit de manière cohérente 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 complet du 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.

Drapeau Signification
ADVERTISEFLAGS_MACHINEASSIGN
0
Définissez pour publier une installation par ordinateur du produit disponible pour tous les utilisateurs.
ADVERTISEFLAGS_USERASSIGN
1
Définissez la publication d’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 du préfixe @ ou | caractère pour spécifier la mise en cache sécurisée des transformations. Le préfixe @ spécifie les transformations secure-at-source et le | le préfixe indique des transformations de chemin d’accès complet sécurisées. Pour plus d’informations, consultez transformations sécurisées. Ce paramètre peut être null.

[in] lgidLanguage

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

Valeur de retour

Valeur Signification
ERROR_SUCCESS
La fonction s’est terminée correctement.
Une 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 est effectuée pour générer un script de publication sur n’importe quelle plateforme autre que Windows 2000 ou Windows XP. La publication sur l’ordinateur local est prise en charge sur toutes les plateformes.

Remarques

Note

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.

Exigences

Exigence Valeur
client minimum 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. Consultez la configuration requise de Windows Installer Run-Time pour plus d’informations sur le service pack Windows minimal requis par une version de Windows Installer.
plateforme cible Windows
d’en-tête msi.h
bibliothèque Msi.lib
DLL Msi.dll

Voir aussi

Multiple-Package Installations