Partager via


WcsSetUsePerUserProfiles, fonction (icm.h)

Permet à un utilisateur de spécifier s’il faut ou non utiliser une liste d’association de profils par utilisateur pour l’appareil spécifié.

Syntaxe

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

Paramètres

pDeviceName

Pointeur vers une chaîne qui contient le nom convivial de l’appareil.

dwDeviceClass

Valeur d’indicateur qui spécifie la classe de l’appareil. Ce paramètre doit prendre l’une des valeurs suivantes :

Valeur Description
CLASS_MONITOR Spécifie un périphérique d’affichage.
CLASS_PRINTER Spécifie une imprimante.
CLASS_SCANNER Spécifie un appareil de capture d’image.

usePerUserProfiles

Valeur booléenne true si l’utilisateur souhaite utiliser une liste d’association de profils par utilisateur pour l’appareil spécifié ; sinon , FALSE.

Valeur retournée

Si cette fonction réussit, la valeur de retour est TRUE.

Si cette fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Si usePerUserProfiles a la valeur TRUE et que l’utilisateur n’utilise pas déjà une liste d’associations de profils par utilisateur pour pDeviceName, la liste d’associations de profils par utilisateur est initialisée en effectuant une copie de la liste d’association de profils à l’échelle du système pour le même appareil. À partir de là, les modifications apportées à la liste à l’échelle du système ne sont pas incluses dans la liste par utilisateur.

Cette fonction est exécutable dans Least-Privileged contexte de compte d’utilisateur (LUA).

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
En-tête icm.h
Bibliothèque Mscms.lib
DLL Mscms.dll

Voir aussi