WcsSetUsePerUserProfiles function

The WcsSetUsePerUserProfiles function allows the user to specify whether or not to use a per-user profile association list for the specified device.

Syntax


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

Parameters

pDeviceName [in]

A pointer to a string that contains the friendly name of the device.

dwDeviceClass [in]

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 [in]

A Boolean value that is TRUE if the user wants to use a per-user profile association list for the specified device; otherwise FALSE.

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

This function will fail if the device pointed to by pDeviceName is not of the class specified by dwDeviceClass.

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

Requirements

Target platform

Universal

Version

Included in Windows Vista and later.

Header

Icm.h

Library

Mscms.lib

DLL

Mscms.dll

See also

WcsGetUsePerUserProfiles

 

 

Send comments about this topic to Microsoft

Show: