MsiIsProductElevatedW, fonction (msi.h)

Article
11/20/2024

La fonction MsiIsProductElevated retourne si le produit est géré ou non. Seules les applications qui nécessitent des privilèges élevés pour l’installation et qui sont installées via la publication sont considérées comme gérées, ce qui signifie qu’une application installée par machine est toujours considérée comme gérée.

Une application installée par utilisateur est considérée comme gérée uniquement si elle est annoncée par un processus de système local qui emprunte l’identité de l’utilisateur. Pour plus d’informations, consultez Publicité d’une application Per-User à installer avec des privilèges élevés.

MsiIsProductElevated vérifie que le système local possède les données du Registre de produits. La fonction ne fait pas référence à des stratégies de compte telles que AlwaysInstallElevated.

Syntaxe

UINT MsiIsProductElevatedW(
  [in]  LPCWSTR szProduct,
  [out] BOOL    *pfElevated
);

Paramètres

[in] szProduct

GUID de code de produit complet du produit.

Ce paramètre est obligatoire et ne peut pas être null ou vide.

[out] pfElevated

Pointeur vers un boOL pour le résultat.

Ce paramètre ne peut pas être NULL.

Valeur de retour

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS et pfElevated est définie sur TRUE si le produit est une application managée.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur identifiés dans le tableau suivant.

Retourner le code	Description
ERROR_UNKNOWN_PRODUCT	Le produit n’est pas connu actuellement.
ERROR_INVALID_PARAMETER	Un argument non valide est passé à la fonction.
ERROR_BAD_CONFIGURATION	Les informations de configuration du produit ne sont pas valides.
ERROR_FUNCTION_FAILED	Échec de la fonction.
ERROR_CALL_NOT_IMPLEMENTED	La fonction n’est pas disponible pour une plateforme spécifique.

Remarques

Note

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

détermination du contexte d’installation

installation d’un package avec des privilèges élevés pour un non administrateur

Partager via