Share via

Função SetStandardColorSpaceProfileW (icm.h)

  • Artigo

Registra um perfil especificado para um determinado espaço de cor padrão. O perfil pode ser consultado usando GetStandardColorSpaceProfileW.

Sintaxe

BOOL SetStandardColorSpaceProfileW(
  PCWSTR pMachineName,
  DWORD  dwProfileID,
  PCWSTR pProfileName
);

Parâmetros

pMachineName

Reservado. Deve ser NULL. Esse parâmetro destina-se a apontar para o nome do computador no qual definir um perfil de espaço de cor padrão. Um ponteiro NULL indica o computador local.

dwProfileID

Especifica o valor da ID do espaço de cor padrão que o perfil fornecido representa. Esse é um valor de ID personalizado usado para identificar exclusivamente o perfil de espaço de cor em seu aplicativo.

pProfileName

Aponta para um caminho totalmente qualificado para o arquivo de 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 já deve estar instalado no sistema antes de ser registrado para um espaço de cor padrão.

Essa função dá suporte a DMPs (perfis de modelo de dispositivo) do WCS (Sistema de Cores do Windows), além de perfis do ICC (International Color Consortium). Ele não dá suporte a perfis WCS CAMP ou GMMP e retornará um erro se esses perfis forem usados.

Suporte por usuário/LUA

Isso registrará um perfil especificado para um determinado espaço de cor padrão somente para o usuário atual.

Isso usa WcsSetDefaultColorProfile com WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER.

Isso será executável no contexto LUA se o perfil já estiver instalado, caso contrário, falhará com acesso negado, pois a instalação é em todo o sistema e requer privilégios de administrador.

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