Compartir a través de

Función UpdateICMRegKeyA (wingdi.h)

  • Artículo

(obsoleto; retenido por compatibilidad con versiones anteriores)

La función UpdateICMRegKey administra perfiles de color y módulos de administración de colores en el sistema.

Sintaxis

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

Parámetros

reserved

Reservado, debe establecerse en cero.

lpszCMID

Apunta a una cadena que especifica el identificador de perfil ICC para que el archivo DLL de administración de colores se use con el perfil.

lpszFileName

Apunta a un nombre de archivo de perfil de color ICC completo o a una estructura de DEVMODE.

command

Especifica una función que se va a ejecutar. Puede tener uno de los siguientes valores.

 

Valor Significado
ICM_ADDPROFILE
 Instala el perfil ICC en el sistema.
ICM_DELETEPROFILE
 Desinstala el perfil ICC del sistema, pero no elimina el archivo.
ICM_QUERYPROFILE
 Determina si el perfil ya está instalado en el sistema.
ICM_SETDEFAULTPROFILE
 Hace que el perfil sea el primero entre iguales.
ICM_REGISTERICMATCHER
 Registra un CMM en el sistema. El parámetro pszFileName apunta a una ruta de acceso completa para el archivo DLL de CMM. El parámetro lpszCMID apunta a un DWORD identificar el CMM.
ICM_UNREGISTERICMATCHER
 Anula el registro del CMM del sistema. El parámetro lpszCMID apunta a un DWORD identificar el CMM.
ICM_QUERYMATCH
 Determina si existe un perfil basado en la estructura de DEVMODE a la que apunta el parámetro pszFileName.

Valor devuelto

Si esta función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en esta función, el valor devuelto es FALSE.

Observaciones

No todos los parámetros se usan en todas las funciones. El parámetro nCommand especifica la función que se va a ejecutar.

Esta función se conserva por compatibilidad con versiones anteriores y se puede quitar en versiones futuras de ICM.

Windows 95/98/Me: updateICMRegKeyW es compatible con la capa de Microsoft para Unicode. Para usarlo, debe agregar determinados archivos a la aplicación, como se describe en Microsoft Layer for Unicode en Windows 95/98/Me Systems.

Nota

El encabezado wingdi.h define UpdateICMRegKey como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de wingdi.h
biblioteca de Gdi32.lib
DLL de Gdi32.dll

Consulte también