Função SetColorProfileElement (icm.h)
Define os dados do elemento para um elemento de perfil marcado em um perfil de cor ICC.
Sintaxe
BOOL SetColorProfileElement(
HPROFILE hProfile,
TAGTYPE tag,
DWORD dwOffset,
PDWORD pcbElement,
PVOID pElement
);
Parâmetros
hProfile
Especifica um identificador para o perfil ICC em questão.
tag
Identifica o elemento marcado.
dwOffset
Especifica o deslocamento do primeiro byte dos dados do elemento marcado no qual começar a gravar.
pcbElement
Ponteiro para uma variável que contém o número de bytes de dados a serem gravados. No retorno, ele contém o número de bytes realmente gravados.
pElement
Ponteiro para um buffer que contém os dados a serem gravados no elemento marcado no perfil de cor.
Retornar valor
Se essa função for bem-sucedida, o valor retornado será TRUE.
Se essa função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Essa função falhará se hProfile não for um perfil ICC válido.
Se o perfil de cor não estiver aberto para permissão de leitura/gravação, essa função falhará.
Se dwOffset exceder o conjunto de tamanhos para o elemento marcado especificado, essa função falhará.
Se dwOffset + *pcbSize for maior que o tamanho do elemento especificado, essa função gravará apenas quantos bytes caberão dentro do tamanho atual do elemento.
Todos os dados existentes na parte especificada do elemento marcado são substituídos quando essa função é bem-sucedida.
Essa função não dá suporte aos perfis DO SISTEMA de Cores do Windows (WCS) CAMP, DMP e GMMP; porque os elementos de perfil são implicitamente associados e codificados em código para tipos de marca ICC e existem muitas bibliotecas de análise XML robustas.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | icm.h |
| Biblioteca | Mscms.lib |
| DLL | Mscms.dll |