GetColorProfileFromHandle 函数 (icm.h)

给定打开的颜色配置文件的句柄， GetColorProfileFromHandle 函数会将配置文件的内容复制到应用程序提供的缓冲区中。如果句柄是 Windows 颜色系统 (WCS) 句柄，则返回 DMP 并忽略与 HPROFILE 关联的 CAMP 和 GMMP。

语法

BOOL GetColorProfileFromHandle(
  HPROFILE hProfile,
  PBYTE    pProfile,
  PDWORD   pcbProfile
);

hProfile

打开的颜色配置文件的句柄。函数确定 HPROFILE 是否包含 ICC 或 WCS 配置文件信息。

pProfile

指向用于接收原始 ICC 或 DMP 配置文件数据的缓冲区的指针。可以为 NULL。如果是，缓冲区所需的大小将存储在 由Size 指向的内存位置中。可以将缓冲区分配到适当的大小，并且此函数再次调用包含缓冲区地址的 pBuffer 。

pcbProfile

指向保存 pBuffer 指向的缓冲区大小的 DWORD 的指针。返回时，如果函数成功，则用实际使用的缓冲区大小填充它。如果在 pBuffer 设置为 NULL 的情况下调用此函数，则此参数将包含所需缓冲区的大小。

如果此函数成功，则返回值为 TRUE。如果 pBuffer 参数为 NULL，并且缓冲区所需的大小复制到了码Size 中，则返回 FALSE。

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


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