MsiAdvertiseProductExW, fonction (msi.h)
La fonction MsiAdvertiseProductEx génère un script de publication 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 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. 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 complet du package du produit publié.
[in] szScriptfilePath
Chemin complet du 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 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 à 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 de la même fonctionnalité que MsiAdvertiseProduct. Si dwPlatform est 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 publication supplémentaires. La valeur différente de zéro est disponible uniquement dans les versions de Windows Installer fournies avec Windows Server 2003 et Windows XP avec SP1 et versions ultérieures.
Drapeau | Signification |
---|---|
|
Plusieurs instances par le biais de l’indicateur de prise en charge du changement de code de produit. Publie une nouvelle instance du produit. Nécessite que le paramètre szTransforms |
Valeur de retour
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 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
Plusieurs instances via des transformations de code de produit sont disponibles uniquement pour les versions de Windows Installer qui sont livrées avec Windows Server 2003 et Windows XP avec SP1 et versions ultérieures.
Note
L’en-tête msi.h définit MsiAdvertiseProductEx 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
non pris en charge dans Windows Installer 2.0 et versions antérieures