Compartir a través de


Función GetColorDirectoryA (icm.h)

Nota

Esta API puede no estar disponible en futuras versiones. Animamos al software nuevo y existente a usar otras API para las interacciones de perfil de color. Consulte la tabla siguiente para ver algunos ejemplos.

Escenario Mechanism
Enumeración de todos los perfiles instalados Usar WcsEnumColorProfilesSize y WcsEnumColorProfiles o EnumColorProfilesA
Instalar o desinstalar perfiles de color Usar InstallColorProfileA/UninstallColorProfileA
Abrir un archivo de perfil de color directamente Use OpenColorProfileA con dwType=PROFILE_FILENAME en el parámetro struct PROFILE.
O bien, use WcsOpenColorProfileA. Icm.h contiene muchas API que aceptan el HPROFILE devuelto para la manipulación del perfil de color.

Recupera la ruta de acceso del directorio Color de Windows en un equipo especificado.

Sintaxis

BOOL GetColorDirectoryA(
  PCSTR  pMachineName,
  PSTR   pBuffer,
  PDWORD pdwSize
);

Parámetros

pMachineName

Reservados; debe ser NULL. Este parámetro está pensado para apuntar al nombre del equipo en el que se va a instalar el perfil. Un puntero NULL indica el equipo local.

pBuffer

Apunta al búfer en el que se va a colocar la ruta de acceso del directorio de color.

pdwSize

Apunta a una variable que contiene el tamaño en bytes del búfer al que apunta pBuffer. 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

Soporte técnico por usuario o LUA

El directorio de color sigue siendo en todo el sistema. Esta función es 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

Consulte también