WcsSetDefaultColorProfile 函式 (icm.h)
在指定的設定檔管理範圍中，為指定的配置檔案類型設定預設色彩設定檔名稱。
注意
此 API 不支援 HDR 監視器的「進階色彩」設定檔。 使用 ColorProfileSetDisplayDefaultAssociation 來管理進階色彩設定檔。
語法
BOOL WcsSetDefaultColorProfile(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pDeviceName,
COLORPROFILETYPE cptColorProfileType,
COLORPROFILESUBTYPE cpstColorProfileSubType,
DWORD dwProfileID,
LPCWSTR pProfileName
);
參數
scope
指定此設定檔管理作業範圍的 WCS_PROFILE_MANAGEMENT_SCOPE 值。
pDeviceName
要設定預設色彩設定檔之裝置名稱的指標。 如果 為 Null，則會使用與裝置無關的預設設定檔。
cptColorProfileType
指定色彩配置檔案類型的 COLORPROFILETYPE 值。
cpstColorProfileSubType
指定色彩設定檔子類型的 COLORPROFILESUBTYPE 值。
dwProfileID
色彩設定檔所代表之色彩空間的識別碼。 這是用來唯一識別應用程式內色彩空間設定檔的自訂識別碼值。
pProfileName
緩衝區的指標，其保存色彩設定檔的名稱。 請參閱＜備註＞。
傳回值
如果此函式成功，則傳回值為 TRUE。
如果此函式失敗，則傳回值為 FALSE。 如需擴充錯誤資訊，請呼叫 GetLastError。
備註
如果 pProfileName 參數是 Null ，而且 profileManagementScope 參數是WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER， 後續對 WcsSetDefaultColorProfile 的呼叫將會傳回全系統的預設設定檔。
如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，此函式會在 Least-Privileged 使用者帳戶 (LUA) 內容中執行。 否則，需要系統管理許可權。 必須已安裝指定的設定檔，但可能尚未與指定設定檔管理範圍中的指定裝置相關聯。
如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，如果從系統內容啟動，而不是使用者帳戶，此函式將無法正確運作。
當呼叫 WcsSetDefaultColorProfile 以將裝置模型設定檔 DMP 設定為 RGB 或自訂工作區的預設設定檔時，只有類型為 RGBVirtualDevice、SMS 或 CRT 的 DMP 設定檔有效;所有其他專案都無效。
當呼叫 WcsSetDefaultColorProfile 時，將國際色彩聯盟 (ICC) 設定檔設定為 RGB 或自訂工作區的預設設定檔時，只有類別為 「spac」 或 「disp」 的 ICC 設定檔，而 「RGB」 色彩空間有效;所有其他專案都無效。
請參閱有效配置檔案類型/子類型組合的附注。
需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 | icm.h |
| 程式庫 | Mscms.lib |
| Dll | Mscms.dll |