MsiSourceListAddMediaDiskA, fonction (msi.h)

La fonction MsiSourceListAddMediaDisk ajoute ou met à jour un disque de la source multimédia d’un produit ou d’un correctif inscrit. Si le disque spécifié existe déjà, il est mis à jour avec les nouvelles valeurs. Si le disque spécifié n’existe pas, une nouvelle entrée de disque est créée avec les nouvelles valeurs.

Syntaxe

UINT MsiSourceListAddMediaDiskA(
  [in]           LPCSTR            szProductCodeOrPatchCode,
  [in, optional] LPCSTR            szUserSid,
  [in]           MSIINSTALLCONTEXT dwContext,
  [in]           DWORD             dwOptions,
  [in]           DWORD             dwDiskId,
  [in]           LPCSTR            szVolumeLabel,
  [in, optional] LPCSTR            szDiskPrompt
);

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.

[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.

[in] dwDiskId

Ce paramètre fournit l’ID du disque en cours d’ajout ou de mise à jour.

[in] szVolumeLabel

Le szVolumeLabel fournit l’étiquette du disque en cours d’ajout ou de mise à jour. Une mise à jour remplace l’étiquette de volume existante dans le Registre. Pour modifier l’invite de disque uniquement, obtenez l’étiquette de volume existante à partir du Registre et fournissez-la dans cet appel, ainsi que la nouvelle invite de disque. La transmission d’une NULL ou d’une chaîne vide pour szVolumeLabel inscrit une chaîne vide (0 octets de longueur) comme étiquette de volume.

[in, optional] szDiskPrompt

Lors de l’entrée de MsiSourceListAddMediaDisk, szDiskPrompt fournit l’invite de disque du disque en cours d’ajout ou de mise à jour. Une mise à jour remplace l’invite de disque inscrite.
Pour modifier l’étiquette de volume uniquement, obtenez l’invite de disque existante inscrite et fournissez-la lors de l’appel de MsiSourceListAddMediaDisk avec la nouvelle étiquette de volume. Passer NULL ou une chaîne vide inscrit une chaîne vide (0 octets de longueur) comme invite de disque.

Valeur de retour

La fonction msiSourceListAddMediaDisk 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, AllowLockdownBrowse, AllowLockDownMedia et stratégies de AlwaysInstallElevated.

Exigences

Voir aussi

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

ProductCode