Partager via

Fonction AssociateColorProfileWithDeviceA (icm.h)

  • Article

Associe un profil de couleur spécifié à un appareil spécifié.

Notes

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

Syntaxe

BOOL AssociateColorProfileWithDeviceA(
  PCSTR pMachineName,
  PCSTR pProfileName,
  PCSTR 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 associer le profil et l’appareil spécifiés. Un pointeur NULL indique l’ordinateur local.

pProfileName

Pointe vers le nom de fichier du profil à associer.

pDeviceName

Pointe vers le nom de l’appareil à associer.

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

La fonction AssociateColorProfileWithDevice échoue si le profil n’a pas été installé sur l’ordinateur à l’aide de la fonction InstallColorProfileW .

Notez que sous Windows (Windows 95 ou version ultérieure), le pilote de périphérique PostScript pour les imprimantes suppose un modèle couleur CMJN. Par conséquent, toutes les imprimantes PostScript doivent utiliser un profil de couleur CMJN. Windows 2000 n’a pas cette limitation.

Si l’appareil spécifié est un moniteur, cette fonction met à jour le profil par défaut.

Plusieurs profils sont généralement associés aux imprimantes, en fonction des types de papier et d’encre. Il n'y a pas de valeur par défaut. GDI sélectionne le meilleur à partir des profils associés lorsque votre application crée un contexte d’appareil (DC).

Les scanneurs n’ont pas non plus de profil par défaut. Toutefois, il est inhabituel d’associer plusieurs profils à un scanneur.

AssociateColorProfileWithDevice ajoute toujours le profil spécifié à la liste d’association de profils par utilisateur de l’utilisateur actuel pour l’appareil spécifié. Avant d’ajouter le profil à la liste, AssociateColorProfileWithDevice 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, AssociateColorProfileWithDevice ajoute simplement le profil spécifié à la liste d’associations de profils par utilisateur existante pour l’appareil. Si ce n’est pas le cas, AssociateColorProfileWithDevice 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 ajoute ensuite le profil spécifié à 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 10 Build 20348
Serveur minimal pris en charge Windows 10 Build 20348
En-tête icm.h

Voir aussi