MsiSourceListSetInfoA, fonction (msi.h)

La fonction MsiSourceListSetInfo définit des informations sur la liste source d’un produit ou d’un correctif dans un contexte spécifique.

Syntaxe

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

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 est supérieure à 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.

[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 spécifie la signification de szProductCodeOrPatchCode.

Si la propriété définie est « LastUsedSource », ce paramètre spécifie également le type de source en tant que réseau ou URL. Dans ce cas, le paramètre dwOptions doit être une combinaison de l’une des constantes MSISOURCETYPE_ suivantes et de l’une des constantes MSICODE_ suivantes.

[in] szProperty

Le paramètre szProperty indique la valeur de propriété à définir. Toutes les propriétés qui ne peuvent pas être récupérées via MsiSourceListGetInfo peuvent être définies via un appel à MsiSourceListSetInfo. La valeur szProperty peut être l’une des valeurs suivantes.

[in] szValue

Nouvelle valeur de la propriété. Aucune validation de la nouvelle valeur n’est effectuée. Cette valeur ne peut pas être NULL. Il peut s’agir d’une chaîne vide.

Valeur de retour

La fonction MsiSourceListSetInfo 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 la DisableBrowse, AllowLockdownBrowseet stratégies d' AlwaysInstallElevated.

Une exception à la règle ci-dessus définit « LastUsedSource » sur l’une des sources inscrites. Si la source est déjà inscrite, un non-administrateur peut définir « LastUsedSource » sur ses propres installations (gérées ou non gérées) et par ordinateur, quelles que soient les stratégies.

Exigences

Voir aussi

contexte d’installation

msiSourceListGetInfo

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

ProductCode