MsiSourceListClearAllA, fonction (msi.h)

Article
11/20/2024

La fonction MsiSourceListClearAll supprime toutes les sources réseau de la liste source d’un correctif ou d’un produit dans un contexte spécifié. Pour plus d’informations, consultez de résilience source .

Syntaxe

UINT MsiSourceListClearAllA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szUserName,
  [in] DWORD  dwReserved
);

Paramètres

[in] szProduct

Le ProductCode du produit à modifier.

[in] szUserName

Nom d’utilisateur pour une installation par utilisateur. Le nom d’utilisateur doit toujours être au format DOMAIN\USERNAME (ou MACHINENAME\USERNAME pour un utilisateur local).

Chaîne vide ou NULL pour une installation par ordinateur.

[in] dwReserved

Réservé pour une utilisation ultérieure. Cette valeur doit être définie sur 0.

Valeur de retour

La fonction MsiSourceListClearAll retourne les valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	L’utilisateur n’a pas la possibilité d’effacer la liste source de ce produit.
ERROR_BAD_CONFIGURATION	Les données de configuration sont endommagées.
ERROR_BAD_USERNAME	Impossible de résoudre le nom d’utilisateur.
ERROR_FUNCTION_FAILED	La fonction n’a pas réussi.
ERROR_INSTALL_SERVICE_FAILURE	Impossible d’accéder au service d’installation.
ERROR_INVALID_PARAMETER	Un paramètre non valide a été passé à la fonction.
ERROR_SUCCESS	La fonction a réussi.
ERROR_UNKNOWN_PRODUCT	Le produit spécifié est inconnu.

Remarques

Un administrateur peut modifier les installations par ordinateur, leurs propres installations non gérées par utilisateur et les installations gérées par utilisateur pour n’importe quel utilisateur. Un non-administrateur ne peut modifier que les installations par ordinateur et ses propres installations (gérées ou non gérées) par utilisateur. Les utilisateurs peuvent être activés pour rechercher des sources en définissant une stratégie. Pour plus d’informations, consultez la DisableBrowse, AllowLockdownBrowseet stratégies d' AlwaysInstallElevated.

Si une source réseau est la source actuelle du produit, cette fonction force le programme d’installation à rechercher dans la liste source une source valide la prochaine fois qu’une source est nécessaire. Si la source actuelle est multimédia ou une source d’URL, elle est toujours valide après cet appel et la liste source n’est pas recherchée, sauf si MsiSourceListForceResolution est également appelée.

Si le nom d’utilisateur est une chaîne vide ou NULL, la fonction fonctionne sur l’installation par ordinateur du produit. Dans ce cas, si le produit est installé uniquement en tant qu’utilisateur, la fonction retourne ERROR_UNKNOWN_PRODUCT.

Si le nom d’utilisateur n’est pas une chaîne vide ou NULL, il spécifie le nom de l’utilisateur dont l’installation du produit est modifiée. Si le nom d’utilisateur est le nom d’utilisateur actuel, la fonction tente d’abord de modifier une installation non gérée du produit. Si aucune installation non gérée du produit n’est disponible, la fonction tente de modifier une installation gérée par utilisateur du produit. Si aucune installation gérée ou non managée par utilisateur du produit est introuvable, la fonction retourne ERROR_UNKNOWN_PRODUCT, même si le produit est installé par ordinateur.

Cette fonction ne peut pas modifier une installation non gérée pour un utilisateur en plus de l’utilisateur actuel. Si le nom d’utilisateur n’est pas une chaîne vide ou NULL, mais n’est pas l’utilisateur actuel, la fonction recherche uniquement une installation gérée par utilisateur du produit pour l’utilisateur spécifié. Si le produit n’est pas installé comme géré par utilisateur pour l’utilisateur spécifié, la fonction retourne ERROR_UNKNOWN_PRODUCT, même si le produit est installé par ordinateur.

Note

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