GetColorDirectoryW 函数 (icm.h)

注意

此 API 可能在将来的版本中不可用。我们鼓励新的和现有的软件使用其他 API 进行颜色配置文件交互。有关一些示例，请参阅下表。

方案	机制
枚举所有已安装的配置文件	使用 WcsEnumColorProfilesSize 和 WcsEnumColorProfiles 或 EnumColorProfilesW
安装/卸载颜色配置文件	使用 InstallColorProfileW/UninstallColorProfileW
直接打开颜色配置文件	在 PROFILE 结构参数中使用 dwType=PROFILE_FILENAME 的 OpenColorProfileW 。或使用 WcsOpenColorProfileW。 Icm.h 包含许多 API，这些 API 接受返回的 HPROFILE 进行颜色配置文件操作

检索指定计算机上的 Windows COLOR 目录的路径。

语法

BOOL GetColorDirectoryW(
  PCWSTR pMachineName,
  PWSTR  pBuffer,
  PDWORD pdwSize
);

pMachineName

保留;必须为 NULL。此参数旨在指向要安装配置文件的计算机的名称。 NULL 指针指示本地计算机。

pBuffer

指向要在其中放置颜色目录路径的缓冲区。

pdwSize

指向包含 pBuffer 指向的缓冲区的大小（以字节为单位）的变量。返回时，变量包含实际使用或所需的缓冲区的大小。

如果此函数成功，则返回值为 TRUE。

如果此函数失败，则返回值为 FALSE。有关扩展的错误信息，请调用 GetLastError。

每用户/LUA 支持

颜色目录仍然是系统范围的。此函数在 LUA 上下文中是可执行的。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	icm.h
Library	Mscms.lib
DLL	Mscms.dll