GetStandardColorSpaceProfileA 函数 (icm.h)
检索为指定的标准颜色 空间注册的颜色配置文件。
语法
BOOL GetStandardColorSpaceProfileA(
PCSTR pMachineName,
DWORD dwSCS,
PSTR pBuffer,
PDWORD pcbSize
);
parameters
pMachineName
保留。 必须为 NULL。 此参数旨在指向要获取标准颜色空间配置文件的计算机的名称。 NULL 指针指示本地计算机。
dwSCS
指定要为其检索配置文件的标准颜色空间的 ID 值。 此参数的唯一有效值是LCS_sRGB和LCS_WINDOWS_COLOR_SPACE。
pBuffer
指向要在其中放置配置文件名称的缓冲区的指针。 如果 为 NULL,则调用将返回 TRUE ,并将所需的缓冲区大小放置在 pdwSize 中。
pcbSize
指向变量的指针,该变量包含 pProfileName 指向的缓冲区的大小(以字节为单位)。 返回时,变量包含实际使用或所需的缓冲区的大小。
返回值
如果此函数成功,则返回值为 TRUE。
如果此函数失败,则返回值为 FALSE。 有关扩展的错误信息,请调用 GetLastError。
注解
如果 pProfileName 指向的缓冲区将由应用程序动态分配,则应用程序可以调用 GetStandardColorSpaceProfile 函数来检索缓冲区所需的大小。 如果在 pProfileName 设置为 NULL 的情况下调用 GetStandardColorSpaceProfile,它将返回 FALSE,pdwSize 指向的 DWORD 将包含 pProfileName 指向的缓冲区所需的字节数。 然后,应用程序可以分配缓冲区并再次调用 GetStandardColorSpaceProfile, 并将 pProfileName 设置为缓冲区的地址。
除了国际颜色联盟 (ICC) 配置文件外,此函数还支持 Windows 颜色系统 (WCS) 设备模型配置文件 (DMP) 。 它不支持 WCS CAMP 或 GMMP 配置文件,如果使用此类配置文件,将返回错误。
Windows Vista 特定功能概述
除了 ICC 配置文件之外,这还将支持 WCS DMP。 它将不支持 WCS CAMP 或 GMMP 配置文件,并且如果此类配置文件用于此 API,将返回错误。
每用户/LUA 支持
这将检索为当前用户的给定标准颜色空间注册的颜色配置文件。 如果当前用户没有此类设置,它将检索系统范围的设置。
这将 WcsGetDefaultColorProfile 与 WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER 配合使用。
这是 LUA 上下文中的可执行文件。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
标头 | icm.h |
Library | Mscms.lib |
DLL | Mscms.dll |