Función AssociateColorProfileWithDeviceW (icm.h)
Asocia un perfil de color especificado a un dispositivo especificado.
Nota:
Esta API no admite perfiles de "color avanzado" para monitores HDR. Use ColorProfileAddDisplayAssociation para administrar perfiles de color avanzados.
Sintaxis
BOOL AssociateColorProfileWithDeviceW(
PCWSTR pMachineName,
PCWSTR pProfileName,
PCWSTR 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 el equipo 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.
Comentarios
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 tiene ningún valor predeterminado. La GDI selecciona la 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 perfiles por usuario del usuario actual para el 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 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. A partir de ese momento, el usuario actual usará una lista de asociaciones por usuario para el dispositivo especificado, como si se hubiera llamado a WcsSetUsePerUserProfiles para pDevice con el parámetro usePerUserProfiles establecido en TRUE.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado | icm.h |
| Library | Mscms.lib |
| Archivo DLL | Mscms.dll |