Partager via

WcsDisassociateColorProfileFromDevice, fonction (icm.h)

  • Article

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

Voir aussi