Partager via


WcsAssociateColorProfileWithDevice, fonction (icm.h)

Associe un profil de couleur WCS 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 WcsAssociateColorProfileWithDevice(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pProfileName,
  PCWSTR                       pDeviceName
);

Paramètres

scope

Valeur WCS_PROFILE_MANAGEMENT_SCOPE qui spécifie l’étendue de cette opération de gestion de profil, qui peut être à l’échelle du système ou pour l’utilisateur actuel.

pProfileName

Pointeur vers le nom de fichier du profil à associer.

pDeviceName

Pointeur vers le nom de l’appareil auquel le profil doit être associé.

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 WCSAssociateColorProfileWithDevice échoue si le profil n’a pas été installé sur l’ordinateur à l’aide de la fonction InstallColorProfileW .

Si le paramètre profileManagementScope est WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, l’association de profil est à l’échelle du système et s’applique à tous les utilisateurs. Si profileManagementScope est WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, l’association concerne uniquement l’utilisateur actuel.

Cette fonction est exécutable dans Least-Privileged contexte de compte d’utilisateur (LUA) si profileManagementScope est WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER. Sinon, des privilèges d’administration sont requis.

Configuration requise

   
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