Función GetColorDirectoryW (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 EnumColorProfilesW |
Instalar o desinstalar perfiles de color | Usar InstallColorProfileW/UninstallColorProfileW |
Abrir un archivo de perfil de color directamente | Use OpenColorProfileW con dwType=PROFILE_FILENAME en el parámetro struct PROFILE. O bien, use WcsOpenColorProfileW. Icm.h contiene muchas API que aceptan el HPROFILE devuelto para la manipulación de perfiles de color |
Recupera la ruta de acceso del directorio Color de Windows en un equipo especificado.
Sintaxis
BOOL GetColorDirectoryW(
PCWSTR pMachineName,
PWSTR 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 colores sigue siendo de todo el sistema. Esta función es ejecutable en el contexto de LUA.
Requisitos
Requisito | Value |
---|---|
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 |