GetColorDirectory

The GetColorDirectory function retrieves the path of the Windows COLOR directory on a specified machine.

BOOL WINAPI GetColorDirectory(
  PCTSTR pMachineName,  PTSTR pBuffer,   PDWORD pdwSize);

Parameters

  • pMachineName
    Reserved; must be NULL. This parameter is intended to point to the name of the machine on which the profile is to be installed. A NULL pointer indicates the local machine.
  • pBuffer
    Points to the buffer in which the color directory path is to be placed.
  • pdwSize
    Points to a variable containing the size in bytes of the buffer pointed to by pBuffer. On return, the variable contains the size of the buffer actually used or needed.

Return Values

If this function succeeds, the return value is TRUE.

If this function fails, the return value is FALSE. For extended error information, call GetLastError.

Remarks

Per-user/LUA support

Color directory is still system wide. This function is executable in LUA context.

Requirements

**  Windows Vista:** Support for WCS profiles included in Windows Vista and later.
**  Windows NT/2000/XP:** Support for ICC profiles included in Windows 2000 and later.
**  Windows 95/98/Me:** Support for ICC profiles included in Windows 98 and later.
**  Header:** Declared in Icm.h.
**  Library:** Use Mscms.lib.
**  Unicode:** Implemented as Unicode and ANSI versions on Windows 2000/XP/Vista.

See Also

Basic Color Management Concepts, Functions