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 |