AssociateColorProfileWithDevice

[This is preliminary documentation and subject to change.]

The AssociateColorProfileWithDevice function associates a specified color profile with a specified device.

BOOL WINAPI AssociateColorProfileWithDevice(
  PCTSTR pMachineName,  // reserved, must be NULL
  PCTSTR pProfileName,  // file name containing device profile
  PCTSTR pDeviceName    // name of device
);
 

Parameters

pMachineName

Reserved for future use; must be NULL. This parameter is intended to point to the name of the machine on which to associate the specified profile and device. A NULL pointer indicates the local machine.

pProfileName

Points to the file name of the profile to associate.

pDeviceName

Points to the name of the device to associate.

Return Values

If this function succeeds, the return value is TRUE.

If this function fails, the return value is FALSE. For extended error information, call GetLastError.

Remarks

The AssociateColorProfileWithDevice function will fail if the profile has not been installed on the computer using the InstallColorProfile function.

Note that under Windows (Windows 95 or later), the PostScript device driver for printers assumes a CMYK color model. Therefore, all PostScript printers must use a CMYK color profile. Windows NT does not have this limitation.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in icm.h.
  Import Library: Use mscms.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Color Management Overview, ICM 2.0 Functions