SetColorProfileElementReference-Funktion (icm.h)

Artikel
08/24/2023

Erstellt in einem angegebenen ICC-Farbprofil ein neues Tag, das auf dieselben Daten wie ein vorhandenes Tag verweist.

Syntax

BOOL SetColorProfileElementReference(
  HPROFILE hProfile,
  TAGTYPE  newTag,
  TAGTYPE  refTag
);

Parameter

hProfile

Gibt ein Handle für das betreffende ICC-Farbprofil an.

newTag

Gibt das zu erstellende neue Tag an.

refTag

Gibt das vorhandene Tag an, auf dessen Daten vom neuen Tag verwiesen 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

Diese Funktion schlägt fehl, wenn hProfile kein gültiges ICC-Profil ist.

Wenn newTag bereits vorhanden ist oder refTag nicht vorhanden ist, schlägt SetColorProfileElementReference fehl.

Wenn das Farbprofil nicht mit der Lese-/Schreibberechtigung geöffnet wurde, schlägt SetColorProfileElementReference fehl.

Diese Funktion unterstützt keine WCS-Profile (Windows Color System) CAMP, DMP und GMMP. da Profilelemente implizit mit ICC-Tagtypen verknüpft und hart codiert sind und viele robuste XML-Analysebibliotheken vorhanden sind.

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