MsiIsProductElevatedA, fonction (msi.h)

Article
08/24/2023

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 l’installation 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 système local qui emprunte l’identité de l’utilisateur. Pour plus d’informations, consultez Annonce de l’installation d’une application Per-User avec des privilèges élevés.

MsiIsProductElevated vérifie que le système local est propriétaire des données du registre de produits. La fonction ne fait pas référence aux stratégies de compte telles que AlwaysInstallElevated.

Syntaxe

UINT MsiIsProductElevatedA(
  [in]  LPCSTR szProduct,
  [out] BOOL   *pfElevated
);

Paramètres

[in] szProduct

GUID du 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 retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS et pfElevated est défini 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.

Code de retour	Description
ERROR_UNKNOWN_PRODUCT	Le produit n’est actuellement pas connu.
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.

Notes

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

Spécifications


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

Détermination du contexte d’installation

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