WcsGetUsePerUserProfiles

  • Article

Determines whether the user chose to use a per-user profile association list for the specified device.

BOOL WINAPI WcsGetUsePerUserProfiles(
  __in LPCWSTRpDeviceName,
  __in DWORDdwDeviceClass,
  __out BOOL *pUsePerUserProfiles);

Parameters

  • pDeviceName
    A pointer to a string containing the user-friendly name of the device.
  • dwDeviceClass
    A flag value specifying 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.
  • pUsePerUserProfiles
    A pointer to a location to receive a Boolean value that is TRUE if the user chose 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

This function fails if pDeviceName points to a device that is not of the class specified by dwDeviceClass.

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, WcsSetUsePerUserProfiles