MsiSourceListForceResolutionExA, fonction (msi.h)

La fonction MsiSourceListForceResolutionEx supprime l’inscription de la propriété appelée « LastUsedSource ». Cette fonction n’affecte pas la liste source inscrite. Chaque fois que le programme d’installation requiert la source pour réinstaller un produit ou un correctif, il tente d’abord la source inscrite en tant que « LastUsedSource ». En cas d’échec ou si cette inscription est manquante, le programme d’installation recherche les autres sources inscrites jusqu’à ce qu’elle trouve une source valide ou jusqu’à ce que la liste des sources soit épuisée. L’effacement de l’inscription « LastUsedSource » force le programme d’installation à effectuer une résolution source sur les sources inscrites la prochaine fois qu’il requiert la source.

Syntaxe

UINT MsiSourceListForceResolutionExA(
  [in]           LPCSTR            szProductCodeOrPatchCode,
  [in, optional] LPCSTR            szUserSid,
  [in]           MSIINSTALLCONTEXT dwContext,
  [in]           DWORD             dwOptions
);

Paramètres

[in] szProductCodeOrPatchCode

L'ProductCode ou le GUID du correctif du produit ou du correctif. Utilisez une chaîne terminée par null. Si la chaîne dépasse 39 caractères, la fonction échoue et retourne ERROR_INVALID_PARAMETER. Ce paramètre ne peut pas être NULL.

[in, optional] szUserSid

Ce paramètre peut être un SID de chaîne qui spécifie le compte d’utilisateur qui contient le produit ou le correctif. Le SID n’est pas validé ou résolu. Un SID incorrect peut retourner ERROR_UNKNOWN_PRODUCT ou ERROR_UNKNOWN_PATCH. Lors du référencement d’un contexte d’ordinateur, szUserSID doit être NULL et dwContext doit être MSIINSTALLCONTEXT_MACHINE. L’utilisation du SID de l’ordinateur (« S-1-5-18 ») retourne ERROR_INVALID PARAMETER. Lorsque vous référencez le compte d’utilisateur actuel, szUserSID peut être NULL et dwContext peut être MSIINSTALLCONTEXT_USERMANAGED ou MSIINSTALLCONTEXT_USERUNMANAGED.

[in] dwContext

Ce paramètre spécifie le contexte de l’instance de produit ou de correctif. Ce paramètre peut contenir l’une des valeurs suivantes.

[in] dwOptions

La valeur dwOptions détermine l’interprétation de la valeur szProductCodeOrPatchCode .

Valeur de retour

La fonction MsiSourceListForceResolutionEx retourne les valeurs suivantes.

Remarques

Les administrateurs peuvent modifier l’installation d’une instance de produit ou de correctif qui existe sous le contexte de l’ordinateur ou sous leur propre contexte par utilisateur (géré ou non managé.) Ils peuvent modifier l’installation d’une instance de produit ou de correctif qui existe sous le contexte géré par l’utilisateur. Les administrateurs ne peuvent pas modifier l’installation d’un autre utilisateur d’une instance de produit ou de correctif qui existe sous ce contexte non managé par utilisateur.

Les non-administrateurs ne peuvent pas modifier l’installation d’une instance de produit ou de correctif qui existe sous le contexte par utilisateur d’un autre utilisateur (géré ou non managé.) Ils peuvent modifier l’installation d’une instance de produit ou de correctif qui existe sous leur propre contexte non managé par utilisateur. Ils peuvent modifier l’installation d’une instance de produit ou de correctif sous le contexte de l’ordinateur ou leur propre contexte géré par l’utilisateur uniquement s’ils sont activés pour rechercher une source de produit ou de correctif. Les utilisateurs peuvent être activés pour rechercher des sources en définissant une stratégie, pour plus d’informations, consultez DisableBrowse, AllowLockdownBrowseet stratégies de AlwaysInstallElevated.

Exigences

Voir aussi

non pris en charge dans Windows Installer 2.0 et versions antérieures

ProductCode

résilience source