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 |