Partager via

AssociateColorProfileWithDeviceW, fonction (icm.h)

  • Article

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

Notes

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

Syntaxe

BOOL AssociateColorProfileWithDeviceW(
  PCWSTR pMachineName,
  PCWSTR pProfileName,
  PCWSTR 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.

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 de 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. 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 atypique 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 précédemment exprimé le désir d’utiliser une liste d’association de profil par utilisateur pour l’appareil. Dans ce cas, AssociateColorProfileWithDevice ajoute simplement le profil spécifié à la liste d’association de profil par utilisateur existante pour l’appareil. Si ce n’est pas le cas, AssociateColorProfileWithDevice crée une liste d’association de profils par utilisateur pour l’appareil en copiant la liste d’association à 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 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.

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