Función GetStandardColorSpaceProfileW (icm.h)
Recupera el perfil de color registrado para el espacio de colores estándar especificado.
Sintaxis
BOOL GetStandardColorSpaceProfileW(
PCWSTR pMachineName,
DWORD dwSCS,
PWSTR pBuffer,
PDWORD pcbSize
);
Parámetros
pMachineName
Reservado. Debe ser NULL. Este parámetro está pensado para apuntar al nombre del equipo en el que se va a obtener un perfil de espacio de colores estándar. Un puntero NULL indica el equipo local.
dwSCS
Especifica el valor de identificador del espacio de colores estándar para el que se va a recuperar el perfil. Los únicos valores válidos para este parámetro son LCS_sRGB y LCS_WINDOWS_COLOR_SPACE.
pBuffer
Puntero al búfer en el que se va a colocar el nombre del perfil. Si es NULL, la llamada devolverá TRUE y el tamaño necesario del búfer se coloca en pdwSize.
pcbSize
Puntero a una variable que contiene el tamaño en bytes del búfer al que apunta pProfileName. En la devolución, la variable contiene el tamaño del búfer usado o necesario.
Valor devuelto
Si esta función se ejecuta correctamente, el valor devuelto es TRUE.
Si se produce un error en esta función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Si el búfer al que apunta pProfileName debe asignarse dinámicamente una aplicación, la aplicación puede llamar a la función GetStandardColorSpaceProfile para recuperar el tamaño necesario para el búfer. Si se llama a GetStandardColorSpaceProfile con pProfileName establecido en NULL, devolverá FALSE y el DWORD señalado por pdwSize contendrá el número de bytes necesarios para el búfer señalado por pProfileName. Después, la aplicación puede asignar el búfer y llamar a GetStandardColorSpaceProfile de nuevo con pProfileName establecido en la dirección del búfer.
Esta función admite perfiles de modelo de dispositivo (WCS) del Sistema de colores de Windows (WCS) además de perfiles del Consorcio internacional de colores (ICC). No admite perfiles WCS CAMP o GMMP y devolverá un error si se usan dichos perfiles.
Información general sobre la funcionalidad específica de Windows Vista
Esto admitirá las DMP de WCS además de los perfiles ICC. No admitirá perfiles WCS CAMP o GMMP y devolverá un error si estos perfiles se usan con esta API.
Soporte técnico por usuario o LUA
Esto recuperará el perfil de color registrado para el espacio de color estándar especificado para el usuario actual. Si no hay ninguna configuración de este tipo para el usuario actual, recupera la configuración de todo el sistema.
Usa WcsGetDefaultColorProfile con WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER.
Se trata de un archivo ejecutable en el contexto de LUA.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado | icm.h |
| Library | Mscms.lib |
| Archivo DLL | Mscms.dll |