WcsAssociateColorProfileWithDevice function

The WcsAssociateColorProfileWithDevice function associates a specified WCS color profile with a specified device.

Syntax

BOOL WcsAssociateColorProfileWithDevice(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pProfileName,
  PCWSTR                       pDeviceName
);

Parameters

scope

pProfileName

A pointer to the file name of the profile to associate.

pDeviceName

A pointer to the name of the device with which the profile is to be associated.

Return Value

None

Remarks

The WCSAssociateColorProfileWithDevice function will fail if the profile has not been installed on the computer using the InstallColorProfile function (described in the Windows SDK documentation).

If the profileManagementScope parameter is WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, the profile association is system-wide and applies to all users. If profileManagementScope is WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, the association is only for the current user.

This function is executable in Least-Privileged User Account (LUA) context if profileManagementScope is WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER. Otherwise, administrative privileges are required..

Requirements

   
Windows version Included in Windows Vista and later.
Target Platform Universal
Header icm.h
Library Mscms.lib
DLL Mscms.dll

See Also

WcsDisassociateColorProfileFromDevice