AssociateColorProfileWithDeviceA-Funktion (icm.h)
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 AssociateColorProfileWithDeviceA(
PCSTR pMachineName,
PCSTR pProfileName,
PCSTR pDeviceName
);
Parameter
pMachineName
Reserviert. Muss NULL sein. Dieser Parameter soll auf den Namen des Computers verweisen, auf dem das angegebene Profil und gerät zugeordnet werden soll. Ein NULL-Zeiger gibt den lokalen Computer an.
pProfileName
Verweist auf den Dateinamen des zu zuordnenden Profils.
pDeviceName
Verweist 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 InstallColorProfileW-Funktion 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 verfügt nicht über diese Einschränkung.
Wenn das angegebene Gerät ein Monitor ist, aktualisiert diese Funktion das Standardprofil.
Druckern werden in der Regel mehrere Profile zugeordnet, die auf Papier- und Tintentypen 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 mehr als ein Profil zuzuordnen.
AssociateColorProfileWithDevice fügt das angegebene Profil immer der Benutzerprofilzuordnungsliste 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 des Profils pro Benutzer 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 Benutzerprofilzuordnungsliste für das angegebene Gerät, als ob WcsSetUsePerUserProfiles für pDevice aufgerufen wurde, wobei der usePerUserProfiles-Parameter auf TRUE festgelegt ist.
Anforderungen
Unterstützte Mindestversion (Client) | Windows 10 Build 20348 |
Unterstützte Mindestversion (Server) | Windows 10 Build 20348 |
Kopfzeile | icm.h |