Ler em inglês

Compartilhar via


Função EnumColorProfilesA (icm.h)

Enumera todos os perfis que atendem aos critérios de enumeração determinados.

Sintaxe

BOOL EnumColorProfilesA(
  PCSTR      pMachineName,
  PENUMTYPEA pEnumRecord,
  PBYTE      pEnumerationBuffer,
  PDWORD     pdwSizeOfEnumerationBuffer,
  PDWORD     pnProfiles
);

Parâmetros

pMachineName

Reservado. Deve ser NULL. Esse parâmetro destina-se a apontar para o nome do computador no qual enumerar perfis. Um ponteiro NULL indica o computador local.

pEnumRecord

Ponteiro para uma estrutura que especifica os critérios de enumeração.

pEnumerationBuffer

Ponteiro para um buffer no qual os perfis devem ser enumerados. Uma MULTI_SZ cadeia de caracteres de nomes de perfil que satisfazem os critérios especificados em *pEnumRecord será colocada nesse buffer.

pdwSizeOfEnumerationBuffer

Ponteiro para uma variável que contém o tamanho do buffer apontado por pBuffer. No retorno, *pdwSize contém o tamanho do buffer realmente usado ou necessário.

pnProfiles

Ponteiro para uma variável que conterá, no retorno, o número de nomes de perfil realmente copiados para o buffer.

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

Vários perfis normalmente são associados a impressoras, com base nos tipos de papel e tinta. Há um perfil padrão para cada dispositivo. Para perfis do ICC (International Color Consortium), o GDI seleciona o melhor dos perfis associados ao ICC quando seu aplicativo cria um DC (contexto de dispositivo).

Não tente usar EnumColorProfiles para determinar o perfil padrão de um dispositivo. Em vez disso, crie um contexto de dispositivo para o dispositivo e, em seguida, invoque a função GetICMProfile . No Windows Vista e no Windows 7, a função WcsGetDefaultColorProfile também pode ser usada para determinar o perfil de cor padrão de um dispositivo.

Se o membro dwFields da estrutura do tipo ENUMTYPE apontado pelo parâmetro pEnumRecord estiver definido como ET_DEVICENAME, essa função enumerará todos os perfis de cor associados a todos os tipos de dispositivos anexados ao computador do usuário, independentemente da classe de dispositivo. Se o membro dwFields da estrutura apontada pelo parâmetro pEnumRecord for definido como ET_DEVICENAME ou ET_DEVICECLASS e uma classe de dispositivo for especificada no membro dwDeviceClass da estrutura, essa função só enumerará os perfis associados à classe de dispositivo especificada. Se o membro dwFields for definido apenas como ET_DEVICECLASS, a função EnumColorProfiles enumerará todos os perfis que podem ser associados a esse tipo de dispositivo.

Sempre que EnumColorProfiles estiver examinando os perfis associados a um dispositivo específico, os resultados dependerão se o usuário optou por usar a lista de perfis em todo o sistema associados a esse dispositivo ou sua própria lista ("por usuário"). Chamar WcsSetUsePerUserProfiles com seu parâmetro usePerUserProfiles definido como TRUE faz com que chamadas futuras para EnumColorProfiles examinem apenas a lista de associações de perfil por usuário do usuário atual para o dispositivo especificado. Chamar WcsSetUsePerUserProfiles com seu parâmetro usePerUserProfiles definido como FALSE faz com que chamadas futuras para EnumColorProfiles examinem a lista de associações de perfil em todo o sistema para o dispositivo especificado. Se WcsSetUsePerUserProfiles nunca tiver sido chamado para o usuário atual, EnumColorProfiles examinará a lista em todo o sistema.

Seu aplicativo pode usar EnumColorProfiles para obter o tamanho do buffer no qual os perfis são enumerados. Ele deve chamar a função EnumColorProfiles com o parâmetro pBuffer definido como NULL. Quando a função retornar, o parâmetro pdwSize conterá o tamanho do buffer necessário em bytes. Seu programa pode usar essas informações para alocar o buffer de enumeração. Em seguida, ele pode invocar EnumColorProfiles novamente com o parâmetro pBuffer definido como o endereço do buffer.

Essa função fornecerá as informações para converter informações de DMP específicas do WCS para o registro EnumType herdado em habilitar a enumeração de perfil consistente. Os padrões serão os mesmos do ICC se essas informações não estiverem presentes.

Suporte por usuário/LUA

A enumeração é específica para o usuário atual. As associações de dispositivo de usuário em todo o sistema e atuais são consideradas. Para a configuração de perfil padrão, as configurações atuais do usuário substituem as de todo o sistema.

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

Confira também