SetColorProfileElement-Funktion (icm.h)
Legt die Elementdaten für ein markiertes Profilelement in einem ICC-Farbprofil fest.
Syntax
BOOL SetColorProfileElement(
HPROFILE hProfile,
TAGTYPE tag,
DWORD dwOffset,
PDWORD pcbElement,
PVOID pElement
);
Parameter
hProfile
Gibt einen Handle für das betreffenden ICC-Profil an.
tag
Identifiziert das markierte Element.
dwOffset
Gibt den Offset aus dem ersten Byte der markierten Elementdaten an, bei denen das Schreiben gestartet werden soll.
pcbElement
Zeiger auf eine Variable, die die Anzahl der zu schreibenden Bytes enthält. Zur Rückgabe enthält sie die Anzahl von Bytes, die tatsächlich geschrieben wurden.
pElement
Zeiger auf einen Puffer, der die Daten enthält, die in das markierte Element im Farbprofil geschrieben werden sollen.
Rückgabewert
Wenn diese Funktion erfolgreich ist, ist der Rückgabewert WAHR.
Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie getLastError für erweiterte Fehlerinformationen auf.
Hinweise
Diese Funktion schlägt fehl, wenn hProfile kein gültiges ICC-Profil ist.
Wenn das Farbprofil für die Lese-/Schreibberechtigung nicht geöffnet wird, schlägt diese Funktion fehl.
Wenn dwOffset die Größe des angegebenen markierten Elements überschreitet, schlägt diese Funktion fehl.
Wenn dwOffset + *pcbSize größer als die Größe des angegebenen Elements ist, schreibt diese Funktion nur so viele Bytes wie in der aktuellen Größe des Elements.
Alle vorhandenen Daten im angegebenen Teil des markierten Elements werden überschrieben, wenn diese Funktion erfolgreich ist.
Diese Funktion unterstützt keine Windows Color System-Profile (WCS) CAMP, DMP und GMMP; da Profilelemente implizit mit ICC-Tagtypen verknüpft und hart codiert sind, und es gibt viele robuste XML-Analysebibliotheken.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Header | icm.h |
| Bibliothek | Mscms.lib |
| DLL | Mscms.dll |