Partager via

UpdateICMRegKeyW, fonction (wingdi.h)

  • Article

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

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

Syntaxe

BOOL UpdateICMRegKeyW(
  DWORD  reserved,
  LPWSTR lpszCMID,
  LPWSTR 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
 Place le profil en premier parmi les égaux.
ICM_REGISTERICMATCHER
 Inscrit une CMM dans le système. Le paramètre pszFileName pointe vers un chemin d’accès complet pour la DLL CMM. Le paramètre lpszCMID pointe vers un DWORD identifiant la CMM.
ICM_UNREGISTERICMATCHER
 Annule l’inscription de la CMM du système. Le paramètre lpszCMID pointe vers un DWORD identifiant la CMM.
ICM_QUERYMATCH
 Détermine si un profil existe en fonction de la structure DEVMODE pointée par le paramètre pszFileName .

Valeur retournée

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 à des fins de compatibilité descendante et peut être supprimée dans les versions ultérieures d’ICM.

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

Notes

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. La combinaison 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.

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]
Plateforme cible Windows
En-tête wingdi.h
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi