Compartir a través de

Función GetColorDirectoryW (icm.h)

  • Artículo

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

Consulte también