Share via

Função WcsDisassociateColorProfileFromDevice (icm.h)

  • Artigo

Desassocia um perfil de cor WCS especificado de um dispositivo especificado em um computador.

Observação

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

Sintaxe

BOOL WcsDisassociateColorProfileFromDevice(
  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 de todo o sistema ou para o usuário atual.

pProfileName

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

pDeviceName

Um ponteiro para o nome do dispositivo do qual desassociar o perfil.

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

O perfil de cor do WCS deve ser instalado. Além disso, você deve usar o mesmo valor profileManagementScope que quando o dispositivo foi associado ao perfil. Consulte WcsAssociateColorProfileWithDevice.

Se profileManagementScope for WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, a desassociação do perfil será em todo o sistema e se aplicará a todos os usuários. Se profileManagementScope for WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, a desassociação será somente para o usuário atual.

Se mais de um perfil de cor estiver associado a um dispositivo, o WCS usará o último perfil associado como padrão. Por exemplo, se o aplicativo associar sequencialmente três perfis a um dispositivo, o WCS usará o último perfil associado como padrão. Se o aplicativo chamar a função WcsDisassociateColorProfileFromDevice para desassociar o terceiro perfil (que é o padrão neste exemplo), o WCS usará o segundo perfil como padrão.

Se o aplicativo desassociar todos os perfis de um dispositivo, o WCS usará o perfil sRGB como padrão.

Se profileManagementScope for WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, essa função será executável no contexto de conta de usuário Least-Privileged (LUA). 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