setColorProfileElementReference 函式 (icm.h)
在指定的 ICC 色彩設定檔中建立參考與現有標籤相同資料的新標記。
語法
BOOL SetColorProfileElementReference(
HPROFILE hProfile,
TAGTYPE newTag,
TAGTYPE refTag
);
參數
hProfile
指定有問題的 ICC 色彩設定檔控制碼。
newTag
識別要建立的新標記。
refTag
識別要由新標記參考其資料的現有標記。
傳回值
如果此函式成功，則傳回值為 TRUE。
如果此函式失敗，則傳回值為 FALSE。 如需擴充的錯誤資訊，請呼叫 GetLastError。
備註
如果 hProfile 不是有效的 ICC 設定檔，此函式將會失敗。
如果 newTag 已經存在或 refTag 不存在， SetColorProfileElementReference 會失敗。
如果未以讀取/寫入權限開啟色彩設定檔， SetColorProfileElementReference 會失敗。
此函式不支援 Windows Color System (WCS) 設定檔 CAMP、DMP 和 GMMP;因為設定檔元素會隱含地與和硬式編碼為 ICC 標籤類型相關聯，而且有許多健全的 XML 剖析程式庫。
需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 標頭 | icm.h |
| 程式庫 | Mscms.lib |
| Dll | Mscms.dll |