Share via


Função GetColorProfileElementTag (icm.h)

Recupera o nome da marca especificado por dwIndex na tabela de marcas de um determinado perfil de cor do ICC (International Color Consortium), em que dwIndex é um índice baseado em um nessa tabela.

Sintaxe

BOOL GetColorProfileElementTag(
  HPROFILE hProfile,
  DWORD    dwIndex,
  PTAGTYPE pTag
);

Parâmetros

hProfile

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

dwIndex

Especifica o índice baseado em um da marca a ser recuperada.

pTag

Ponteiro para uma variável na qual o nome da marca deve ser colocado.

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.

GetColorProfileElementTag pode ser usado para enumerar todas as marcas em um perfil depois de obter o número de marcas no perfil usando GetCountColorProfileElements.

Essa função não dá suporte a perfis do WCS (Sistema de Cores do Windows) CAMP, DMP e GMMP; porque os elementos de perfil são implicitamente associados e embutidos 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