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 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 de DEVMODE .

command

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

 

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 identificando o CMM.
ICM_UNREGISTERICMATCHER
 Cancela o registro do CMM do sistema. O parâmetro lpszCMID aponta para um DWORD identificando o CMM.
ICM_QUERYMATCH
 Determina se existe um perfil com base na estrutura de DEVMODE apontada pelo parâmetro pszFileName.

Valor de retorno

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

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

Observações

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 é retida para compatibilidade com versões anteriores e pode ser removida em versões futuras do ICM.

Windows 95/98/Me: UpdateICMRegKeyW é compatível com a Camada da Microsoft para Unicode. Para usar isso, você deve adicionar determinados arquivos ao seu aplicativo, conforme descrito em Microsoft Layer for Unicode no Windows 95/98/Me Systems.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho wingdi.h
biblioteca Gdi32.lib
de DLL Gdi32.dll

Consulte também