WcsAssociateColorProfileWithDevice function
The WcsAssociateColorProfileWithDevice
function associates a specified WCS color profile with a specified device.
Syntax
BOOL WcsAssociateColorProfileWithDevice(
_In_ WCS_PROFILE_MANAGEMENT_SCOPE profileManagementScope,
_In_ PCWSTR pProfileName,
_In_ PCWSTR pDeviceName
);
Parameters
profileManagementScope [in]
A WCS_PROFILE_MANAGEMENT_SCOPE value that specifies the scope of this profile management operation.pProfileName [in]
A pointer to the file name of the profile to associate.pDeviceName [in]
A pointer to the name of the device with which the profile is to be associated.
If this function succeeds, the return value is TRUE.
If this function fails, the return value is FALSE. For extended error information, call GetLastError (described in the Microsoft Windows SDK documentation).
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
Target platform |
Universal |
Version |
Included in Windows Vista and later. |
Header |
Icm.h |
Library |
Mscms.lib |
DLL |
Mscms.dll |
See also
WcsDisassociateColorProfileFromDevice