Share via

Função DisassociateColorProfileFromDeviceW (icm.h)

  • Artigo

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

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 DisassociateColorProfileFromDeviceW(
  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 desassociar o perfil e o dispositivo especificados. Um ponteiro NULL indica o computador local.

pProfileName

Ponteiro para o nome do arquivo do perfil a ser desassociado.

pDeviceName

Ponteiro para o nome do dispositivo a ser desassociado.

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

Se mais de um perfil estiver associado a um dispositivo, o WCS usará o último associado como padrão. Ou seja, se o aplicativo associar sequencialmente três perfis a um dispositivo, o WCS usará o último associado como padrão. Se o aplicativo chamar a função DisassociateColorProfileFromDevice 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.

DisassociateColorProfileFromDevice sempre remove o perfil especificado da lista de associação de perfil por usuário do usuário atual para o dispositivo especificado. Antes de remover o perfil da lista, DisassociateColorProfileFromDevice 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, DisassociateColorProfileFromDevice simplesmente remove o perfil especificado da lista de associação de perfil por usuário existente para o dispositivo. Caso contrário, DisassociateColorProfileFromDevice 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, ele remove o perfil especificado da 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