MsiAdvertiseProductExA, fonction (msi.h)

Article
02/29/2024

La fonction MsiAdvertiseProductEx génère un script de publicité ou publie un produit sur l’ordinateur. Cette fonction permet à Windows Installer 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. La fonction MsiAdvertiseProductEx fournit les mêmes fonctionnalités que MsiAdvertiseProduct.

Syntaxe

UINT MsiAdvertiseProductExA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szScriptfilePath,
  [in] LPCSTR szTransforms,
  [in] LANGID lgidLanguage,
  [in] DWORD  dwPlatform,
  [in] DWORD  dwOptions
);

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 à créer avec les informations publiées. 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 des 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ées. Pour plus d’informations, consultez Transformations sécurisées. Ce paramètre peut avoir la valeur null.

[in] lgidLanguage

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

[in] dwPlatform

Indicateurs de bits qui contrôlent la plateforme pour laquelle le programme d’installation doit créer le script. Ce paramètre est ignoré si szScriptfilePath a la valeur Null. Si dwPlatform est égal à zéro (0), le script est créé en fonction de la plateforme actuelle. Il s’agit des mêmes fonctionnalités que MsiAdvertiseProduct. Si dwPlatform a la valeur 1 ou 2, le programme d’installation crée un script pour la plateforme spécifiée.

Indicateur	Signification
Aucune 0	Crée un script pour la plateforme actuelle.
MSIARCHITECTUREFLAGS_X86 1	Crée un script pour la plateforme x86.
MSIARCHITECTUREFLAGS_IA64 2	Crée un script pour les systèmes Itanium.
MSIARCHITECTUREFLAGS_AMD64 4	Crée un script pour la plateforme x64.

[in] dwOptions

Indicateurs de bits qui spécifient des options de publicité supplémentaires. Une valeur différente de zéro n’est disponible que dans les versions de Windows Installer fournies avec Windows Server 2003 et Windows XP avec SP1 et versions ultérieures.

Indicateur	Signification
MSIADVERTISEOPTIONS_INSTANCE 1	Plusieurs instances via l’indicateur de prise en charge de la transformation de modification du code de produit. Publie une nouvelle instance du produit. Nécessite que le paramètre szTransforms inclue la transformation instance qui modifie le code produit. Pour plus d’informations, consultez Installation de plusieurs instances de produits et de correctifs.

Valeur retournée

Valeur	Signification
ERROR_SUCCESS	La fonction s’exécute correctement.
Erreur liée à une action	Pour plus d’informations, 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.

Remarques

Plusieurs instances via le code de produit : les transformations de modification du code de produit sont uniquement disponibles pour les versions de Windows Installer livrées avec Windows Server 2003 et Windows XP avec SP1 et versions ultérieures.

Notes

L’en-tête msi.h définit MsiAdvertiseProductEx comme un 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.

Configuration requise

Condition requise	Valeur
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

Non pris en charge par Windows Installer 2.0 et antérieur

Partager via