WcsDisassociateColorProfileFromDevice 函数 (icm.h)
从计算机上的指定设备取消关联指定的 WCS 颜色配置文件。
注意
此 API 不支持 HDR 监视器的“高级颜色”配置文件。 使用 ColorProfileRemoveDisplayAssociation 管理高级颜色配置文件。
语法
BOOL WcsDisassociateColorProfileFromDevice(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pProfileName,
PCWSTR pDeviceName
);
parameters
scope
一个WCS_PROFILE_MANAGEMENT_SCOPE值，该值指定此配置文件管理操作的范围，可以是系统范围，也可以是当前用户。
pProfileName
指向要取消关联的配置文件的文件名的指针。
pDeviceName
指向要取消关联配置文件的设备名称的指针。
返回值
如果此函数成功，则返回值为 TRUE。
如果此函数失败，则返回值为 FALSE。 有关扩展的错误信息，请调用 GetLastError。
注解
应安装 WCS 颜色配置文件。 此外，必须使用与设备与配置文件关联的相同 profileManagementScope 值。 请参阅 WcsAssociateColorProfileWithDevice。
如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE，则配置文件取消关联是系统范围的，并适用于所有用户。 如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，则取消关联仅适用于当前用户。
如果多个颜色配置文件与设备相关联，WCS 将使用最后一个关联的配置文件作为默认值。 例如，如果应用程序按顺序将三个配置文件与设备关联，则 WCS 将使用关联的最后一个配置文件作为默认值。 如果应用程序随后调用 WcsDisassociateColorProfileFromDevice 函数来取消关联第三个配置文件 (这是本示例中的默认配置文件) ，则 WCS 将使用第二个配置文件作为默认值。
如果应用程序取消关联设备中的所有配置文件，WCS 将使用 sRGB 配置文件作为默认值。
如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，则此函数在 Least-Privileged 用户帐户 (LUA) 上下文中可执行。 否则，需要管理权限。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 标头 | icm.h |
| Library | Mscms.lib |
| DLL | Mscms.dll |