Share via

Função WcsAssociateColorProfileWithDevice (icm.h)

  • Artigo

Associa um perfil de cor WCS 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 WcsAssociateColorProfileWithDevice(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pProfileName,
  PCWSTR                       pDeviceName
);

Parâmetros

scope

Um valor WCS_PROFILE_MANAGEMENT_SCOPE que especifica o escopo dessa operação de gerenciamento de perfil, que pode ser em todo o sistema ou para o usuário atual.

pProfileName

Um ponteiro para o nome do arquivo do perfil a ser associado.

pDeviceName

Um ponteiro para o nome do dispositivo ao qual o perfil deve 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 WCSAssociateColorProfileWithDevice falhará se o perfil não tiver sido instalado no computador usando a função InstallColorProfileW .

Se o parâmetro profileManagementScope for WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, a associação de perfil será em todo o sistema e se aplicará a todos os usuários. Se profileManagementScope for WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, a associação será apenas para o usuário atual.

Essa função será executável no contexto da conta de usuário Least-Privileged (LUA) se profileManagementScope for WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER. Caso contrário, privilégios administrativos são necessários.

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