DisassociateColorProfileFromDeviceA, fonction (icm.h)

Article
08/24/2023

Dissocie un profil de couleur spécifié avec un appareil spécifié sur un ordinateur spécifié.

Notes

Cette API ne prend pas en charge les profils de couleur avancés pour les moniteurs HDR. Utilisez ColorProfileRemoveDisplayAssociation pour gérer les profils de couleurs avancés.

Syntaxe

BOOL DisassociateColorProfileFromDeviceA(
  PCSTR pMachineName,
  PCSTR pProfileName,
  PCSTR pDeviceName
);

Paramètres

pMachineName

Réservé. Doit être NULL. Ce paramètre est destiné à pointer vers le nom de l’ordinateur sur lequel dissocier le profil et l’appareil spécifiés. Un pointeur NULL indique l’ordinateur local.

pProfileName

Pointeur vers le nom de fichier du profil à dissocier.

pDeviceName

Pointeur vers le nom de l’appareil à dissocier.

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.

Remarques

Si plusieurs profils sont associés à un appareil, WCS utilise le dernier profil associé comme profil par défaut. Autrement dit, si votre application associe séquentiellement trois profils à un appareil, WCS utilise le dernier associé comme profil par défaut. Si votre application appelle ensuite la fonction DisassociateColorProfileFromDevice 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.

DisassociateColorProfileFromDevice supprime toujours le profil spécifié de la liste d’association de profils par utilisateur de l’utilisateur actuel pour l’appareil spécifié. Avant de supprimer le profil de la liste, DisassociateColorProfileFromDevice détermine si l’utilisateur a précédemment exprimé le désir d’utiliser une liste d’association de profil par utilisateur pour l’appareil. Dans ce cas, DisassociateColorProfileFromDevice supprime simplement le profil spécifié de la liste d’association de profil par utilisateur existante pour l’appareil. Si ce n’est pas le cas, DisassociateColorProfileFromDevice crée une liste d’association de profil par utilisateur pour l’appareil en copiant la liste d’association à l’échelle du système pour cet appareil. Il supprime ensuite le profil spécifié de la liste par utilisateur. À partir de ce point, l’utilisateur actuel utilise une liste d’association de profil par utilisateur pour l’appareil spécifié, comme si WcsSetUsePerUserProfiles avait été appelé pour pDevice avec le paramètre usePerUserProfiles défini sur TRUE.

Configuration requise

Condition requise	Valeur
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

Partager via