setStandardColorSpaceProfileA 函式 (icm.h)
為指定的標準 色彩空間註冊指定的設定檔。 您可以使用 GetStandardColorSpaceProfileW查詢設定檔。
語法
BOOL SetStandardColorSpaceProfileA(
PCSTR pMachineName,
DWORD dwProfileID,
PCSTR pProfilename
);
參數
pMachineName
保留的。 必須是 Null。 此參數旨在指向要設定標準色彩空間設定檔的電腦名稱稱。 Null指標表示本機電腦。
dwProfileID
指定指定設定檔所代表之標準色彩空間的識別碼值。 這是用來唯一識別應用程式內色彩空間設定檔的自訂識別碼值。
pProfilename
指向設定檔案的完整路徑。
傳回值
如果此函式成功，則傳回值為 TRUE。
如果此函式失敗，則傳回值為 FALSE。 如需擴充的錯誤資訊，請呼叫 GetLastError。
備註
設定檔必須先安裝在系統上，才能註冊標準色彩空間。
除了國際色彩聯盟 ( () 設定檔之外，此函式還支援 Windows Color System (WCS) 裝置型號設定檔 (DMP) 。 它不支援 WCS CAMP 或 GMMP 設定檔，如果使用這類設定檔，則會傳回錯誤。
個別使用者/LUA 支援
這只會為目前使用者註冊指定標準色彩空間的指定設定檔。
這會使用 WcsSetDefaultColorProfile 搭配WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER。
如果設定檔已安裝，則這是 LUA 內容中的可執行檔，否則會因為安裝是全系統且需要系統管理員許可權而拒絕存取而失敗。
需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 標頭 | icm.h |
| 程式庫 | Mscms.lib |
| Dll | Mscms.dll |