MsiAdvertiseProductExA, fonction (msi.h)

Article
11/20/2024

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 MsiAdvertiseProductExA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szScriptfilePath,
  [in] LPCSTR 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.

Drapeau	Signification
ADVERTISEFLAGS_MACHINEASSIGN 0	Défini 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 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.

Drapeau	Signification
aucun 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 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
MSIADVERTISEOPTIONS_INSTANCE 1	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 inclut la transformation d’instance qui modifie le code produit. Pour plus d’informations, consultez Installation de plusieurs instances de produits et de correctifs.

Valeur de retour

Valeur	Signification
ERROR_SUCCESS	La fonction s’exécute correctement.
Une 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 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

Partager via