WcsSetUsePerUserProfiles-Funktion (icm.h)

  • Artikel

Ermöglicht es einem Benutzer, anzugeben, ob eine Benutzerprofilzuordnungsliste für das angegebene Gerät verwendet werden soll.

Syntax

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

Parameter

pDeviceName

Ein Zeiger auf eine Zeichenfolge, die den benutzerfreundlichen Namen des Geräts enthält.

dwDeviceClass

Ein Flagwert, der die Klasse des Geräts angibt. Dieser Parameter muss einen der folgenden Werte annehmen:

Wert BESCHREIBUNG
CLASS_MONITOR Gibt ein Anzeigegerät an.
CLASS_PRINTER Gibt einen Drucker an.
CLASS_SCANNER Gibt ein Bildaufnahmegerät an.

usePerUserProfiles

Ein boolescher Wert, der TRUE ist, wenn der Benutzer eine Benutzerprofilzuordnungsliste für das angegebene Gerät verwenden möchte; andernfalls FALSE.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Wenn usePerUserProfilesAUF TRUE festgelegt ist und der Benutzer noch keine Zuordnungsliste pro Benutzerprofil für pDeviceName verwendet, wird die Zuordnungsliste pro Benutzerprofil initialisiert, indem eine Kopie der systemweiten Profilzuordnungsliste für dasselbe Gerät erstellt wird. Ab dann sind Änderungen an der systemweiten Liste nicht mehr in der Liste pro Benutzer enthalten.

Diese Funktion ist im LUA-Kontext (User Account) Least-Privileged ausführbar.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile icm.h
Bibliothek Mscms.lib
DLL Mscms.dll

Weitere Informationen