Partager via

UpdateICMRegKeyA, fonction (wingdi.h)

  • Article

(obsolète ; conservé pour la compatibilité descendante)

La fonction UpdateICMRegKey gère les profils de couleur et les modules de gestion des couleurs dans le système.

Syntaxe

BOOL UpdateICMRegKeyA(
  DWORD reserved,
  LPSTR lpszCMID,
  LPSTR lpszFileName,
  UINT  command
);

Paramètres

reserved

Réservé, doit être défini sur zéro.

lpszCMID

Pointe vers une chaîne qui spécifie l’identificateur de profil ICC pour la DLL de gestion des couleurs à utiliser avec le profil.

lpszFileName

Pointe vers un nom de fichier de profil de couleur ICC complet ou vers une structure DEVMODE .

command

Spécifie une fonction à exécuter. Il peut avoir l’une des valeurs suivantes.

 

Valeur Signification
ICM_ADDPROFILE
 Installe le profil ICC dans le système.
ICM_DELETEPROFILE
 Désinstalle le profil ICC du système, mais ne supprime pas le fichier.
ICM_QUERYPROFILE
 Détermine si le profil est déjà installé dans le système.
ICM_SETDEFAULTPROFILE
 Rend le profil d’abord parmi les égaux.
ICM_REGISTERICMATCHER
 Inscrit un CMM dans le système. Le paramètre pszFileName pointe vers un chemin complet pour la DLL CMM. Le paramètre lpszCMID pointe vers un DWORD identifiant le CMM.
ICM_UNREGISTERICMATCHER
 Annule l’inscription du CMM à partir du système. Le paramètre lpszCMID pointe vers un DWORD identifiant le CMM.
ICM_QUERYMATCH
 Détermine si un profil existe en fonction de la structure DEVMODE pointée par le paramètre pszFileName.

Valeur de retour

Si cette fonction réussit, la valeur de retour est TRUE.

Si cette fonction échoue, la valeur de retour est FALSE.

Remarques

Tous les paramètres ne sont pas utilisés par toutes les fonctions. Le paramètre nCommand spécifie la fonction à exécuter.

Cette fonction est conservée pour la compatibilité descendante et peut être supprimée dans les futures versions d’ICM.

Windows 95/98/Me : UpdateICMRegKeyW est pris en charge par la couche Microsoft pour Unicode. Pour l’utiliser, vous devez ajouter certains fichiers à votre application, comme indiqué dans Microsoft Layer pour Unicode sur Windows 95/98/Me Systems.

Note

L’en-tête wingdi.h définit UpdateICMRegKey comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence Valeur
client minimum pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge Windows 2000 Server [applications de bureau uniquement]
plateforme cible Windows
d’en-tête wingdi.h
bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi