Edit

WcsSetUsePerUserProfiles function (icm.h)

  • Article

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

Syntax

BOOL WcsSetUsePerUserProfiles(
  LPCWSTR pDeviceName,
  DWORD   dwDeviceClass,
  BOOL    usePerUserProfiles
);

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:

Value Description
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 value

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

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header icm.h
Library Mscms.lib
DLL Mscms.dll

See also