Função DisassociateColorProfileFromDeviceW (icm.h)
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 |