WcsAssociateColorProfileWithDevice-Funktion (icm.h)

Artikel
08/24/2023

Ordnet einem angegebenen Gerät ein angegebenes WCS-Farbprofil zu.

Hinweis

Diese API unterstützt keine "erweiterten Farbprofile" für HDR-Monitore. Verwenden Sie ColorProfileAddDisplayAssociation zum Verwalten erweiterter Farbprofile.

Syntax

BOOL WcsAssociateColorProfileWithDevice(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pProfileName,
  PCWSTR                       pDeviceName
);

Parameter

scope

Ein WCS_PROFILE_MANAGEMENT_SCOPE Wert, der den Bereich dieses Profilverwaltungsvorgangs angibt, der systemweit oder für den aktuellen Benutzer sein kann.

pProfileName

Ein Zeiger auf den Dateinamen des zu zuordnenden Profils.

pDeviceName

Ein Zeiger auf den Namen des Geräts, dem das Profil zugeordnet werden soll.

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

Die WCSAssociateColorProfileWithDevice-Funktion schlägt fehl, wenn das Profil nicht mithilfe der InstallColorProfileW-Funktion auf dem Computer installiert wurde.

Wenn der parameter profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE ist, ist die Profilzuordnung systemweit und gilt für alle Benutzer. Wenn profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER ist, gilt die Zuordnung nur für den aktuellen Benutzer.

Diese Funktion ist im Least-Privileged LUA-Kontext (User Account, Benutzerkonto) ausführbar, wenn profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER ist. Andernfalls sind Administratorrechte erforderlich.

Anforderungen


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