Compartir a través de

Función GetICMProfileA (wingdi.h)

  • Artículo

La función GetICMProfile recupera el nombre de archivo del perfil de color de salida actual para un contexto de dispositivo especificado.

Sintaxis

BOOL GetICMProfileA(
  HDC     hdc,
  LPDWORD pBufSize,
  LPSTR   pszFilename
);

Parámetros

hdc

Especifica un contexto de dispositivo desde el que se va a recuperar el perfil de color.

pBufSize

Puntero a un DWORD de que contiene el tamaño del búfer al que apunta lpszFilename. Para la versión ANSI de esta función, el tamaño está en bytes. Para la versión Unicode, el tamaño está en WCHAR. Si esta función se ejecuta correctamente, al devolver este parámetro, contiene el tamaño del búfer que se usa realmente. Sin embargo, si el búfer no es lo suficientemente grande, esta función devuelve FALSE. En este caso, la función GetLastError() devuelve ERROR_INSUFFICIENT_BUFFER y el DWORD apuntado por este parámetro contiene el tamaño necesario para el búfer de lpszFilename.

pszFilename

Apunta al búfer que recibe el nombre de ruta de acceso del perfil.

Valor devuelto

Si esta función se ejecuta correctamente, el valor devuelto es TRUE. También devuelve TRUE si el parámetro lpszFilename es NULL y el tamaño necesario para el búfer se copia en lpcbName.

Si se produce un error en esta función, el valor devuelto es FALSE.

Observaciones

GetICMProfile obtiene el nombre de archivo del perfil de salida actual, independientemente de si la administración de colores está habilitada o no para el contexto del dispositivo.

Dado un contexto de dispositivo, getICMProfile generará, a través del parámetro lpszFilename, el nombre de ruta de acceso del archivo que contiene el perfil de color que usa actualmente el contexto del dispositivo. También generará, a través del parámetro lpcbName, la longitud de la cadena que contiene el nombre de la ruta de acceso.

Es posible que el nombre del perfil devuelto por GetICMProfile no esté en la lista de perfiles devueltos por EnumICMProfiles. La función EnumICMProfiles devuelve todos los perfiles de espacio de color asociados a un contexto de dispositivo (DC) cuya configuración coincide con la del controlador de dominio. Si la función SetICMProfile se usa para establecer el perfil actual, es posible que un perfil esté asociado al controlador de dominio que no coincida con su configuración. Por ejemplo, la función setICMProfile se puede usar para asociar el perfil sRGB independiente del dispositivo con un controlador de dominio. Este perfil se usará como el perfil de WCS actual para ese controlador de dominio y las llamadas a GetICMProfile devolverán su nombre de archivo. Sin embargo, el perfil no aparecerá en la lista de perfiles que se devuelven de EnumICMProfiles.

Si se llama a esta función antes de que se llame a cualquier llamada a la función SetICMProfile, se puede usar para obtener el perfil predeterminado para un contexto de dispositivo.

Windows 95/98/Me: GetICMProfileW es compatible con Microsoft Layer para Unicode. Para usarlo, debe agregar determinados archivos a la aplicación, como se describe en Microsoft Layer for Unicode en Windows 95/98/Me Systems.

Nota

El encabezado wingdi.h define GetICMProfile como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de wingdi.h
biblioteca de Gdi32.lib
DLL de Gdi32.dll

Consulte también