Compartilhar via


Função SetStandardColorSpaceProfileA (icm.h)

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

Sintaxe

BOOL SetStandardColorSpaceProfileA(
  PCSTR pMachineName,
  DWORD dwProfileID,
  PCSTR 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 Sistema de Cores do Windows (WCS), 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, o acesso será negado, pois a instalação é de 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