WcsSetUsePerUserProfiles

Enables a user to specify whether or not to use a per-user profile association list for the specified device.

BOOL WINAPI WcsSetUsePerUserProfiles(  __in LPCWSTRpDeviceName,
  __in DWORDdwDeviceClass,
  __in BOOLusePerUserProfiles);

Parameters

• pDeviceName
  A pointer to a string that contains the user-friendly name of the device.
• dwDeviceClass
  A flag value that specifies the class of the device. This parameter must take one of the following values:
  • CLASS_MONITOR
    Specifies a display device.
  • CLASS_PRINTER
    Specifies a printer.
  • CLASS_SCANNER
    Specifies an image capture device.
• usePerUserProfiles
  A Boolean value that is TRUE if the user wants to use a per-user profile association list for the specified device; otherwise FALSE.

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

If usePerUserProfiles is TRUE, and the user is not already using a per-user profile association list for pDeviceName, then the per-user profile association list is initialized by making a copy of the system-wide profile association list for the same device. From then on, changes to the system-wide list are not included in the per-user list.

This function is executable in Least-Privileged User Account (LUA) context.

Requirements

**  Windows Vista:** Included in Windows Vista and later.
**  Header:** Declared in Icm.h.
**  Library:** Use Mscms.lib.
**  Unicode:** Implemented as Unicode and ANSI versions on Windows Vista.

See Also

Basic Color Management Concepts, Windows Color System Schemas and Algorithms, Functions, WcsGetUsePerUserProfiles