Share via

Função AssociateColorProfileWithDeviceW (icm.h)

  • Artigo

Associa um perfil de cor especificado a um dispositivo especificado.

Observação

Essa API não dá suporte a perfis de "cor avançada" para monitores HDR. Use ColorProfileAddDisplayAssociation para gerenciar perfis de cores avançados.

Sintaxe

BOOL AssociateColorProfileWithDeviceW(
  PCWSTR pMachineName,
  PCWSTR pProfileName,
  PCWSTR pDeviceName
);

Parâmetros

pMachineName

Reservado. Deve ser NULL. Esse parâmetro destina-se a apontar para o nome do computador no qual associar o perfil e o dispositivo especificados. Um ponteiro NULL indica o computador local.

pProfileName

Aponta para o nome do arquivo a ser associado.

pDeviceName

Aponta para o nome do dispositivo a ser associado.

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

A função AssociateColorProfileWithDevice falhará se o perfil não tiver sido instalado no computador usando a função InstallColorProfileW .

Observe que, em Windows (Windows 95 ou posterior), o driver de dispositivo PostScript para impressoras pressupõe um modelo de cor CMYK. Portanto, todas as impressoras PostScript devem usar um perfil de cor CMYK. O Windows 2000 não tem essa limitação.

Se o dispositivo especificado for um monitor, essa função atualizará o perfil padrão.

Vários perfis normalmente são associados a impressoras, com base em tipos de papel e tinta. Não há nenhum padrão. A GDI seleciona a melhor dos perfis associados quando seu aplicativo cria um DC (contexto de dispositivo).

Os scanners também não têm perfil padrão. No entanto, é atípico associar mais de um perfil a um scanner.

AssociateColorProfileWithDevice sempre adiciona o perfil especificado à lista de associações de perfil por usuário do usuário atual para o dispositivo especificado. Antes de adicionar o perfil à lista, AssociateColorProfileWithDevice determina se o usuário expressou anteriormente o desejo de usar uma lista de associação de perfil por usuário para o dispositivo. Nesse caso, AssociateColorProfileWithDevice simplesmente adiciona o perfil especificado à lista de associação de perfil por usuário existente para o dispositivo. Caso contrário, AssociateColorProfileWithDevice cria uma nova lista de associação de perfil por usuário para o dispositivo copiando a lista de associações em todo o sistema para esse dispositivo. Em seguida, acrescenta o perfil especificado à lista por usuário. Desse ponto em diante, o usuário atual usará uma lista de associação de perfil por usuário para o dispositivo especificado, como se WcsSetUsePerUserProfiles tivesse sido chamado para pDevice com o parâmetro usePerUserProfiles definido como TRUE.

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