WcsAssociateColorProfileWithDevice, fonction (icm.h)

  • Article
  • 2 minutes de lecture

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ée » 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.

Remarques

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 profils est à l’échelle du système et s’applique à tous les utilisateurs. Si profileManagementScope est WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, l’association n’est destinée qu’à l’utilisateur actuel.

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

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