MsiSourceListAddSourceExA, fonction (msi.h)

La fonction MsiSourceListAddSourceEx ajoute ou réorganise l’ensemble de sources d’un correctif ou d’un produit dans un contexte spécifié. Il peut également créer une liste source pour un correctif qui n’existe pas dans le contexte spécifié.

Syntaxe

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

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 détermine l’interprétation de la valeur szProductCodeOrPatchCode et le type de sources à effacer. Ce paramètre doit être une combinaison de l’une des constantes MSISOURCETYPE_ suivantes et de l’une des constantes MSICODE_ suivantes.

[in] szSource

Source à ajouter ou déplacer. Ce paramètre doit contenir uniquement le chemin d’accès sans le nom de fichier. Le nom de fichier est déjà inscrit en tant que « PackageName » et peut être manipulé via MsiSourceListSetInfo. Cet argument est obligatoire.

[in, optional] dwIndex

Ce paramètre fournit le nouvel index pour la source. Toutes les sources sont indexées dans la liste source comprise entre 1 et N, où N est le nombre de sources dans la liste. Chaque source de la liste a un index unique.

Si MsiSourceListAddSourceEx est appelé avec une nouvelle source et dwIndex défini sur 0 (zéro), la nouvelle source est ajoutée à la liste existante. Si dwIndex est défini sur 0 et que la source existe déjà dans la liste, aucune mise à jour n’est effectuée sur la liste.

Si MsiSourceListAddSourceEx est appelé avec une nouvelle source et dwIndex défini sur une valeur non nulle inférieure au nombre (N), la nouvelle source est placée à l’index spécifié et les autres sources sont réindexées. Si la source existe déjà, elle est déplacée vers l’index spécifié et les autres sources sont réindexées.

Si MsiSourceListAddSourceEx est appelé avec une nouvelle source et dwIndex défini sur une valeur non nulle supérieure au nombre de sources (N), la nouvelle source est ajoutée à la liste existante. Si la source existe déjà, elle est déplacée à la fin de la liste et les autres sources sont réindexées.

Valeur de retour

La fonction MsiSourceListAddSourceEx 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.

Exigences

Voir aussi

AllowLockdownBrowse

AlwaysInstallElevated

DisableBrowse

MsiSourceListSetInfo

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

ProductCode

résilience source