WcsSetUsePerUserProfiles-Funktion (icm.h)

Artikel
02/26/2024

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

Freigeben über