WcsGetUsePerUserProfiles function (icm.h)

  • Article

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

Syntax

BOOL WcsGetUsePerUserProfiles(
  LPCWSTR pDeviceName,
  DWORD   dwDeviceClass,
  PBOOL   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.

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

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

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