WcsDisassociateColorProfileFromDevice, fonction (icm.h)
Dissocie un profil de couleur WCS spécifié d’un appareil spécifié sur un ordinateur.
Notes
Cette API ne prend pas en charge les profils de « couleur avancée » pour les moniteurs HDR. Utilisez ColorProfileRemoveDisplayAssociation pour gérer les profils de couleurs avancés.
Syntaxe
BOOL WcsDisassociateColorProfileFromDevice(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pProfileName,
PCWSTR pDeviceName
);
Paramètres
scope
Valeur WCS_PROFILE_MANAGEMENT_SCOPE qui spécifie l’étendue de cette opération de gestion de profil, qui peut être à l’échelle du système ou pour l’utilisateur actuel.
pProfileName
Pointeur vers le nom de fichier du profil à dissocier.
pDeviceName
Pointeur vers le nom de l’appareil à partir duquel dissocier le profil.
Valeur retournée
Si cette fonction réussit, la valeur de retour est TRUE.
Si cette fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Notes
Le profil de couleur WCS doit être installé. En outre, vous devez utiliser la même valeur profileManagementScope que lorsque l’appareil était associé au profil. Consultez WcsAssociateColorProfileWithDevice.
Si profileManagementScope est WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, la dissociation de profil est à l’échelle du système et s’applique à tous les utilisateurs. Si profileManagementScope est WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, la dissociation concerne uniquement l’utilisateur actuel.
Si plusieurs profils de couleur sont associés à un appareil, WCS utilise le dernier profil associé comme profil par défaut. Par exemple, si votre application associe séquentiellement trois profils à un appareil, WCS utilise le dernier profil associé comme profil par défaut. Si votre application appelle ensuite la fonction WcsDisassociateColorProfileFromDevice pour dissocier le troisième profil (qui est la valeur par défaut dans cet exemple), WCS utilise le deuxième profil comme profil par défaut.
Si votre application dissocie tous les profils d’un appareil, WCS utilise le profil sRGB comme profil par défaut.
Si profileManagementScope est WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, cette fonction est exécutable dans Least-Privileged contexte compte d’utilisateur (LUA). Dans le cas contraire, des privilèges d’administration sont requis.
Configuration requise
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| En-tête | icm.h |
| Bibliothèque | Mscms.lib |
| DLL | Mscms.dll |