Partager via

Fonction DisassociateColorProfileFromDeviceW (icm.h)

  • Article

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ée » pour les moniteurs HDR. Utilisez ColorProfileRemoveDisplayAssociation pour gérer les profils de couleurs avancés.

Syntaxe

BOOL DisassociateColorProfileFromDeviceW(
  PCWSTR pMachineName,
  PCWSTR pProfileName,
  PCWSTR pDeviceName
);

Paramètres

pMachineName

Réservé. Doit avoir la valeur 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.

Notes

Si plusieurs profils sont associés à un appareil, WCS utilise le dernier associé comme profil par défaut. Autrement dit, si votre application associe séquentiellement trois profils à un appareil, WCS utilise le dernier associé comme valeur 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), le 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’associations 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 déjà exprimé le désir d’utiliser une liste d’associations de profils par utilisateur pour l’appareil. Si c’est le cas, DisassociateColorProfileFromDevice supprime simplement le profil spécifié de la liste d’associations de profils par utilisateur existante pour l’appareil. Si ce n’est pas le cas, DisassociateColorProfileFromDevice crée une liste d’associations de profils par utilisateur pour l’appareil en copiant la liste d’associations à 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 profils par utilisateur pour l’appareil spécifié, comme si WcsSetUsePerUserProfiles avait été appelé pour pDevice avec le paramètre usePerUserProfiles défini sur TRUE.

Spécifications

   
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