Compartilhar via


Função GetColorDirectoryW (icm.h)

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 EnumColorProfilesW
Instalando/desinstalando perfis de cores Usar InstallColorProfileW/UninstallColorProfileW
Abrindo um arquivo de perfil de cor diretamente Use OpenColorProfileW com dwType=PROFILE_FILENAME no parâmetro struct PROFILE.
Ou use WcsOpenColorProfileW. 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 GetColorDirectoryW(
  PCWSTR pMachineName,
  PWSTR  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

Requisito Valor
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