Compartilhar via

Função GetColorDirectoryA (icm.h)

  • Artigo

Observação

Essa API pode estar indisponível em versões futuras. Incentivamos o software novo e existente a usar outras APIs para interações de perfil de cor. Consulte a tabela abaixo para obter alguns exemplos.

Cenário Mecanismo
Enumerando todos os perfis instalados Usar WcsEnumColorProfilesSize e WcsEnumColorProfiles ou EnumColorProfilesA
Instalando/desinstalando perfis de cores Usar InstallColorProfileA/UninstallColorProfileA
Abrindo um arquivo de perfil de cor diretamente Use OpenColorProfileA com dwType=PROFILE_FILENAME no parâmetro struct PROFILE.
Ou use WcsOpenColorProfileA. Icm.h contém muitas APIs que aceitam o HPROFILE retornado para manipulação de perfil de cor

Recupera o caminho do diretório COLOR do Windows em um computador especificado.

Sintaxe

BOOL GetColorDirectoryA(
  PCSTR  pMachineName,
  PSTR   pBuffer,
  PDWORD pdwSize
);

Parâmetros

pMachineName

Reservados; deve ser NULL. Esse parâmetro destina-se a apontar para o nome do computador no qual o perfil deve ser instalado. Um ponteiro NULL indica o computador local.

pBuffer

Aponta para o buffer no qual o caminho do diretório de cores deve ser colocado.

pdwSize

Aponta para uma variável que contém o tamanho em bytes do buffer apontado por pBuffer. No retorno, a variável contém o tamanho do buffer realmente usado ou necessário.

Retornar valor

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

Suporte por usuário/LUA

O diretório de cores ainda é de todo o sistema. Essa função é executável no contexto LUA.

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