AssociateColorProfileWithDeviceA, fonction (icm.h)

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

Syntaxe

BOOL AssociateColorProfileWithDeviceA(
  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 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.

Remarques

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 de couleur CMYK. Par conséquent, toutes les imprimantes PostScript doivent utiliser un profil de couleur CMYK. 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 papier et encre. Il n’y a pas de valeur par défaut. Le GDI sélectionne le meilleur parmi les 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’associations de profil 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 précédemment exprimé le désir d’utiliser une liste d’associations par utilisateur pour l’appareil. Dans ce cas, AssociateColorProfileWithDevice ajoute simplement le profil spécifié à la liste d’associations de profil par utilisateur existante pour l’appareil. Si ce n’est pas le cas, AssociateColorProfileWithDevice crée une liste d’associations de profil 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 stade, l’utilisateur actuel utilise une liste d’associations 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

Voir aussi

• Concepts de base de la gestion des couleurs
• Fonctions
• DisassociateColorProfileFromDevice