UpdateICMRegKeyA, fonction (wingdi.h)

Article
08/27/2023

(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 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	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

Partager via