MsiSourceListClearMediaDiskA, fonction (msi.h)

Article
02/29/2024

La fonction MsiSourceListClearMediaDisk permet de supprimer un disque inscrit existant sous la source multimédia d’un produit ou d’un correctif dans un contexte spécifique.

Syntaxe

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

Paramètres

[in] szProductCodeOrPatchCode

ProductCode ou GUID de correctif du produit ou du correctif. Utilisez une chaîne terminée par null. Si la chaîne contient plus de 39 caractères, la fonction échoue et retourne ERROR_INVALID_PARAMETER. Ce paramètre ne peut pas avoir la valeur 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.

Type de SID	Signification
NULL	NULL désigne l’utilisateur actuellement connecté. Lors du référencement du compte d’utilisateur actuel, szUserSID peut avoir la valeur NULL et dwContext peut être MSIINSTALLCONTEXT_USERMANAGED ou MSIINSTALLCONTEXT_USERUNMANAGED.
SID de l’utilisateur	Spécifie l’énumération d’un utilisateur particulier dans le système. Un exemple de SID utilisateur est « S-1-3-64-2415071341-1358098788-3127455600-2561 ».

Note La chaîne SID spéciale s-1-5-18 (système) ne peut pas être utilisée pour énumérer les produits ou les correctifs installés en tant que machine. La définition de la valeur SID sur s-1-5-18 renvoie ERROR_INVALID_PARAMETER. Lorsque dwContext est défini sur MSIINSTALLCONTEXT_MACHINE uniquement, szUserSid doit avoir la valeur NULL.

Note La chaîne SID spéciale s-1-1-0 (tout le monde) ne doit pas être utilisée. La définition de la valeur SID sur s-1-1-0 échoue et retourne ERROR_INVALID_PARAM.

[in] dwContext

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

Type de contexte	Signification
MSIINSTALLCONTEXT_USERMANAGED	Le produit ou le correctif instance existe dans le contexte géré par utilisateur.
MSIINSTALLCONTEXT_USERUNMANAGED	Le produit ou le correctif instance existe dans le contexte non managé par utilisateur.
MSIINSTALLCONTEXT_MACHINE	Le produit ou le correctif instance existe dans le contexte par machine.

[in] dwOptions

La valeur dwOptions spécifie la signification de szProductCodeOrPatchCode.

Indicateur	Signification
MSICODE_PRODUCT	szProductCodeOrPatchCode est un GUID de code produit.
MSICODE_PATCH	szProductCodeOrPatchCode est un GUID de code correctif.

[in] dwDiskId

Ce paramètre fournit l’ID du disque en cours de suppression.

Valeur retournée

La fonction MsiSourceListClearMediaDisk retourne les valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	L’utilisateur n’a pas la possibilité de lire la source multimédia spécifiée ou le produit ou le correctif spécifié. Cela n’indique pas si une source multimédia, un produit ou un correctif a été trouvé.
ERROR_BAD_CONFIGURATION	Les données de configuration sont endommagées.
ERROR_INSTALL_SERVICE_FAILURE	Impossible d’accéder au service Windows Installer.
ERROR_INVALID_PARAMETER	Un paramètre non valide a été transmis à la fonction.
ERROR_SUCCESS	La valeur a été supprimée ou introuvable.
ERROR_UNKNOWN_PATCH	Le correctif est introuvable.
ERROR_UNKNOWN_PRODUCT	Le produit est introuvable.
ERROR_FUNCTION_FAILED	Défaillance interne inattendue.

Remarques

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

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

Notes

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

Configuration requise

Condition requise	Valeur
Client minimal 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 3.0 ou version ultérieure sur Windows Server 2003 ou Windows XP. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows.
Plateforme cible	Windows
En-tête	msi.h
Bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

Non pris en charge par Windows Installer 2.0 et antérieur

ProductCode

Partager via