AssociateColorProfileWithDeviceA-Funktion (icm.h)

Ordnet ein angegebenes Farbprofil einem angegebenen Gerät zu.

Syntax

BOOL AssociateColorProfileWithDeviceA(
  PCSTR pMachineName,
  PCSTR pProfileName,
  PCSTR pDeviceName
);

Die 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

Verweist auf den Dateinamen des zuzuordnenden Profils.

pDeviceName

Verweist auf den Namen des Zuzuordnenden Geräts.

Rückgabewert

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

Wenn diese Funktion fehlschlägt, lautet der Rückgabewert FALSCH. Rufen Sie getLastError für erweiterte Fehlerinformationen auf.

Bemerkungen

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

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

Wenn das angegebene Gerät ein Monitor ist, aktualisiert diese Funktion das Standardprofil.

Mehrere Profile sind in der Regel Druckern zugeordnet, basierend auf Papier- und Freihandtypen. Es ist keine Standardeinstellung vorhanden. Die GDI wählt das beste aus den zugeordneten Profilen aus, wenn Ihre Anwendung einen Gerätekontext (DC) erstellt.

Scanner haben auch kein Standardprofil. Es ist jedoch atypisch, mehrere Profile einem Scanner zuzuordnen.

AssociateColorProfileWithDevice fügt das angegebene Profil immer zur Benutzerprofilzuordnungsliste des aktuellen Benutzers für das angegebene Gerät hinzu. Bevor Sie das Profil zur Liste hinzufügen, bestimmt AssociateColorProfileWithDevice , ob der Benutzer zuvor den Wunsch geäußert hat, eine Benutzerprofilzuordnungsliste für das Gerät zu verwenden. In diesem Fall fügt AssociateColorProfileWithDevice einfach das angegebene Profil zur vorhandenen Benutzerprofilzuordnungsliste 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 Benutzerliste 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 Parameter usePerUserProfiles auf TRUE festgelegt ist.

Anforderungen

Siehe auch

• Grundlegende Farbverwaltungskonzepte
• Funktionen
• DisassociateColorProfileFromDevice