Fonction MsiAdvertiseProductExW (msi.h)
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 MsiAdvertiseProductExW(
[in] LPCWSTR szPackagePath,
[in] LPCWSTR szScriptfilePath,
[in] LPCWSTR 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.
[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.
[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 |
---|---|
|
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 |
---|---|
|
La fonction s’exécute correctement. |
|
Pour plus d’informations, consultez Codes d’erreur. |
Une erreur d’initialisation s’est produite. | |
|
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 |