Função GetStandardColorSpaceProfileW (icm.h)
Recupera o perfil de cor registrado para o espaço de cor padrão especificado.
Sintaxe
BOOL GetStandardColorSpaceProfileW(
PCWSTR pMachineName,
DWORD dwSCS,
PWSTR pBuffer,
PDWORD pcbSize
);
Parâmetros
pMachineName
Reservado. Deve ser NULL. Esse parâmetro destina-se a apontar para o nome do computador no qual obter um perfil de espaço de cor padrão. Um ponteiro NULL indica o computador local.
dwSCS
Especifica o valor da ID do espaço de cor padrão para o qual recuperar o perfil. Os únicos valores válidos para esse parâmetro são LCS_sRGB e LCS_WINDOWS_COLOR_SPACE.
pBuffer
Ponteiro para o buffer no qual o nome do perfil deve ser colocado. Se FOR NULL, a chamada retornará TRUE e o tamanho necessário do buffer será colocado em pdwSize.
pcbSize
Ponteiro para uma variável que contém o tamanho em bytes do buffer apontado por pProfileName. No retorno, a variável contém o tamanho do buffer realmente usado ou necessário.
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
Se o buffer apontado por pProfileName for alocado dinamicamente por um aplicativo, o aplicativo poderá chamar a função GetStandardColorSpaceProfile para recuperar o tamanho necessário para o buffer. Se GetStandardColorSpaceProfile for chamado com pProfileName definido como NULL, ele retornará FALSE e o DWORD apontado por pdwSize conterá o número de bytes necessários para o buffer apontado por pProfileName. Em seguida, o aplicativo pode alocar o buffer e chamar GetStandardColorSpaceProfile novamente com pProfileName definido como o endereço do buffer.
Essa função dá suporte a DMPs (perfis de modelo de dispositivo) do WCS (Sistema de Cores do Windows), além de perfis do ICC (International Color Consortium). Ele não dá suporte a perfis WCS CAMP ou GMMP e retornará um erro se esses perfis forem usados.
Visão geral da funcionalidade específica do Windows Vista
Isso dará suporte a DMPs do WCS, além de perfis ICC. Ele não dará suporte a perfis WCS CAMP ou GMMP e retornará um erro se esses perfis forem usados com essa API.
Suporte por usuário/LUA
Isso recuperará o perfil de cor registrado para o espaço de cor padrão especificado para o usuário atual. Se não houver essa configuração para o usuário atual, ela recuperará a configuração de todo o sistema.
Isso usa WcsGetDefaultColorProfile com WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER.
Isso é 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 |