AssociateColorProfileWithDeviceW-Funktion (icm.h)

Artikel
08/24/2023

Ordnet einem angegebenen Gerät ein angegebenes Farbprofil zu.

Hinweis

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

Syntax

BOOL AssociateColorProfileWithDeviceW(
  PCWSTR pMachineName,
  PCWSTR pProfileName,
  PCWSTR pDeviceName
);

Parameter

pMachineName

Reserviert. Muss NULL sein. Dieser Parameter soll auf den Namen des Computers verweisen, auf dem das angegebene Profil und das angegebene Gerät zugeordnet werden sollen. Ein NULL-Zeiger gibt den lokalen Computer an.

pProfileName

Zeigt auf den Dateinamen des zu zuordnenden Profils.

pDeviceName

Zeigt auf den Namen des zu zuordnenden Geräts.

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 AssociateColorProfileWithDevice-Funktion schlägt fehl, wenn das Profil nicht mithilfe der Funktion InstallColorProfileW auf dem Computer installiert wurde.

Beachten Sie, dass unter Windows (Windows 95 oder höher) der PostScript-Gerätetreiber für Drucker von einem CMYK-Farbmodell ausgeht. Daher müssen alle PostScript-Drucker ein CMYK-Farbprofil verwenden. Windows 2000 hat diese Einschränkung nicht.

Wenn es sich bei dem angegebenen Gerät um einen Monitor handelt, aktualisiert diese Funktion das Standardprofil.

Druckern werden in der Regel mehrere Profile zugeordnet, die auf Papier- und Freihandtypen basieren. Es gibt keinen Standardwert. Der GDI wählt das beste aus den zugeordneten Profilen aus, wenn Ihre Anwendung einen Gerätekontext (Device Context, DC) erstellt.

Scanner verfügen auch über kein Standardprofil. Es ist jedoch untypisch, einem Scanner mehrere Profile zuzuordnen.

AssociateColorProfileWithDevice fügt das angegebene Profil immer der Zuordnungsliste des aktuellen Benutzerprofils für das angegebene Gerät hinzu. Vor dem Hinzufügen des Profils zur Liste bestimmt AssociateColorProfileWithDevice , ob der Benutzer zuvor den Wunsch geäußert hat, eine Benutzerprofilzuordnungsliste für das Gerät zu verwenden. Wenn dies der Fall ist, fügt AssociateColorProfileWithDevice einfach das angegebene Profil der vorhandenen Zuordnungsliste pro Benutzerprofil für das Gerät hinzu. Andernfalls erstellt AssociateColorProfileWithDevice eine neue Benutzerprofilzuordnungsliste für das Gerät, indem die systemweite Zuordnungsliste für dieses Gerät kopiert wird. Anschließend wird das angegebene Profil an die Liste pro Benutzer angefügt. Ab diesem Zeitpunkt verwendet der aktuelle Benutzer eine Profilzuordnungsliste pro Benutzer für das angegebene Gerät, als ob WcsSetUsePerUserProfiles für pDevice aufgerufen wurde und der usePerUserProfiles-Parameter auf TRUE festgelegt ist.

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