SetColorProfileElement, fonction (icm.h)

Article
08/24/2023

Définit les données d’élément d’un élément de profil balisé dans un profil de couleur ICC.

Syntaxe

BOOL SetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement
);

Paramètres

hProfile

Spécifie un handle pour le profil ICC en question.

tag

Identifie l’élément balisé.

dwOffset

Spécifie le décalage par rapport au premier octet des données de l’élément balisé à partir duquel commencer l’écriture.

pcbElement

Pointeur vers une variable contenant le nombre d’octets de données à écrire. Au retour, il contient le nombre d’octets réellement écrits.

pElement

Pointeur vers une mémoire tampon contenant les données à écrire dans l’élément balisé dans le profil de couleur.

Valeur retournée

Si cette fonction réussit, la valeur de retour est TRUE.

Si cette fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Cette fonction échoue si hProfile n’est pas un profil ICC valide.

Si le profil de couleur n’est pas ouvert pour l’autorisation de lecture/écriture, cette fonction échoue.

Si dwOffset dépasse la taille définie pour l’élément balisé spécifié, cette fonction échoue.

Si dwOffset + *pcbSize est supérieur à la taille de l’élément spécifié, cette fonction écrit uniquement autant d’octets que la taille actuelle de l’élément.

Toutes les données existantes dans la partie spécifiée de l’élément balisé sont remplacées lorsque cette fonction réussit.

Cette fonction ne prend pas en charge les profils WINDOWS Color System (WCS) CAMP, DMP et GMMP ; parce que les éléments de profil sont implicitement associés à et codés en dur en types de balises ICC et qu’il existe de nombreuses bibliothèques d’analyse XML robustes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	icm.h
Bibliothèque	Mscms.lib
DLL	Mscms.dll

Partager via