Share via

Função SetColorProfileElementReference (icm.h)

  • Artigo

Cria em um perfil de cor ICC especificado uma nova marca que faz referência aos mesmos dados que uma marca existente.

Sintaxe

BOOL SetColorProfileElementReference(
  HPROFILE hProfile,
  TAGTYPE  newTag,
  TAGTYPE  refTag
);

Parâmetros

hProfile

Especifica um identificador para o perfil de cor ICC em questão.

newTag

Identifica a nova marca a ser criada.

refTag

Identifica a marca existente cujos dados devem ser referenciados pela nova marca.

Valor retornado

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 newTag já existir ou refTag não existir, SetColorProfileElementReference falhará.

Se o perfil de cor não tiver sido aberto com permissão de leitura/gravação, SetColorProfileElementReference falhará.

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

   
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