Compartilhar via

Função UpdateICMRegKeyA (wingdi.h)

  • Artigo

(Obsoleto; retido para compatibilidade com versões anteriores)

A função UpdateICMRegKey gerencia perfis de cores e Módulos de Gerenciamento de Cores no sistema.

Sintaxe

BOOL UpdateICMRegKeyA(
  DWORD reserved,
  LPSTR lpszCMID,
  LPSTR lpszFileName,
  UINT  command
);

Parâmetros

reserved

Reservado, deve ser definido como zero.

lpszCMID

Aponta para uma cadeia de caracteres que especifica o identificador de perfil DO ICC para a DLL de gerenciamento de cores a ser usada com o perfil.

lpszFileName

Aponta para um nome de arquivo de perfil de cor ICC totalmente qualificado ou para uma estrutura DEVMODE .

command

Especifica uma função a ser executada. Ele pode ter um dos valores a seguir.

 

Valor Significado
ICM_ADDPROFILE
 Instala o perfil ICC no sistema.
ICM_DELETEPROFILE
 Desinstala o perfil ICC do sistema, mas não exclui o arquivo.
ICM_QUERYPROFILE
 Determina se o perfil já está instalado no sistema.
ICM_SETDEFAULTPROFILE
 Torna o perfil o primeiro entre iguais.
ICM_REGISTERICMATCHER
 Registra um CMM no sistema. O parâmetro pszFileName aponta para um caminho totalmente qualificado para a DLL do CMM. O parâmetro lpszCMID aponta para um DWORD que identifica o CMM.
ICM_UNREGISTERICMATCHER
 Cancela o registro do CMM do sistema. O parâmetro lpszCMID aponta para um DWORD que identifica o CMM.
ICM_QUERYMATCH
 Determina se existe um perfil com base na estrutura DEVMODE apontada pelo parâmetro pszFileName .

Valor retornado

Se essa função for bem-sucedida, o valor retornado será TRUE.

Se essa função falhar, o valor retornado será FALSE.

Comentários

Nem todos os parâmetros são usados por todas as funções. O parâmetro nCommand especifica a função a ser executada.

Essa função é mantida para compatibilidade com versões anteriores e pode ser removida em versões futuras do ICM.

Windows 95/98/Me: UpdateICMRegKeyW tem suporte da Camada da Microsoft para Unicode. Para usar isso, você deve adicionar determinados arquivos ao seu aplicativo, conforme descrito no Microsoft Layer for Unicode no Windows 95/98/Me Systems.

Observação

O cabeçalho wingdi.h define UpdateICMRegKey como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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]
Plataforma de Destino Windows
Cabeçalho wingdi.h
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também