Función AssociateColorProfileWithDeviceA (icm.h)

Asocia un perfil de color especificado a un dispositivo especificado.

Syntax

BOOL AssociateColorProfileWithDeviceA(
  PCSTR pMachineName,
  PCSTR pProfileName,
  PCSTR pDeviceName
);

Parámetros

pMachineName

Reservado. Debe ser NULL. Este parámetro está pensado para apuntar al nombre de la máquina en la que se va a asociar el perfil y el dispositivo especificados. Un puntero NULL indica la máquina local.

pProfileName

Apunta al nombre de archivo del perfil que se va a asociar.

pDeviceName

Apunta al nombre del dispositivo que se va a asociar.

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. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Se producirá un error en la función AssociateColorProfileWithDevice si el perfil no se ha instalado en el equipo mediante la función InstallColorProfileW .

Tenga en cuenta que en Windows (Windows 95 o posterior), el controlador de dispositivo PostScript para impresoras supone un modelo de color CMYK. Por lo tanto, todas las impresoras PostScript deben usar un perfil de color CMYK. Windows 2000 no tiene esta limitación.

Si el dispositivo especificado es un monitor, esta función actualiza el perfil predeterminado.

Normalmente, varios perfiles están asociados a impresoras, basadas en tipos de papel y tinta. No hay ningún valor predeterminado. El GDI selecciona el mejor de los perfiles asociados cuando la aplicación crea un contexto de dispositivo (DC).

Los escáneres tampoco tienen ningún perfil predeterminado. Sin embargo, es atípico asociar más de un perfil con un escáner.

AssociateColorProfileWithDevice siempre agrega el perfil especificado a la lista de asociaciones de perfil por usuario actual del dispositivo especificado. Antes de agregar el perfil a la lista, AssociateColorProfileWithDevice determina si el usuario ha expresado previamente el deseo de usar una lista de asociaciones por perfil de usuario para el dispositivo. Si es así, AssociateColorProfileWithDevice simplemente agrega el perfil especificado a la lista de asociaciones de perfil por usuario existente para el dispositivo. Si no es así, AssociateColorProfileWithDevice crea una nueva lista de asociaciones de perfil por usuario para el dispositivo copiando la lista de asociaciones de todo el sistema para ese dispositivo. A continuación, anexa el perfil especificado a la lista por usuario. Desde ese momento, el usuario actual usará una lista de asociaciones de perfil por usuario para el dispositivo especificado, como si se hubiera llamado a WcsSetUsePerUserProfiles para pDevice con el parámetro usePerUserProfiles establecido en TRUE.

Requisitos

Consulte también

• Conceptos básicos de administración de colores
• Funciones
• DisassociateColorProfileFromDevice