Función SetColorProfileElement (icm.h)
Establece los datos de elemento de un elemento de perfil etiquetado en un perfil de color ICC.
Sintaxis
BOOL SetColorProfileElement(
HPROFILE hProfile,
TAGTYPE tag,
DWORD dwOffset,
PDWORD pcbElement,
PVOID pElement
);
Parámetros
hProfile
Especifica un identificador para el perfil icc en cuestión.
tag
Identifica el elemento etiquetado.
dwOffset
Especifica el desplazamiento del primer byte de los datos del elemento etiquetado en el que se va a empezar a escribir.
pcbElement
Puntero a una variable que contiene el número de bytes de datos que se van a escribir. A la devolución, contiene el número de bytes escritos realmente.
pElement
Puntero a un búfer que contiene los datos que se van a escribir en el elemento etiquetado del perfil de color.
Valor devuelto
Si esta función se ejecuta correctamente, el valor devuelto es TRUE.
Si se produce un error en esta función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Esta función producirá un error si hProfile no es un perfil ICC válido.
Si el perfil de color no se abre para el permiso de lectura y escritura, se produce un error en esta función.
Si dwOffset supera el tamaño establecido para el elemento etiquetado especificado, se produce un error en esta función.
Si dwOffset + *pcbSize es mayor que el tamaño del elemento especificado, esta función solo escribe tantos bytes como se ajustará dentro del tamaño actual del elemento.
Los datos existentes de la parte especificada del elemento etiquetado se sobrescriben cuando esta función se realiza correctamente.
Esta función no admite perfiles del Sistema de colores de Windows (WCS) CAMP, DMP y GMMP; dado que los elementos de perfil están asociados implícitamente y codificados de forma rígida a los tipos de etiquetas ICC y existen muchas bibliotecas de análisis XML sólidas.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado | icm.h |
| Library | Mscms.lib |
| Archivo DLL | Mscms.dll |