Share via

Função SetColorProfileElement (icm.h)

  • Artigo

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

Confira também