WcsGetDefaultColorProfile 函式 (icm.h)
擷取裝置的預設色彩設定檔，如果未指定裝置，則擷取與裝置無關的預設值。
注意
此 API 不支援 HDR 監視器的「進階色彩」設定檔。 使用 ColorProfileGetDisplayDefault 來管理進階色彩設定檔。
語法
BOOL WcsGetDefaultColorProfile(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pDeviceName,
COLORPROFILETYPE cptColorProfileType,
COLORPROFILESUBTYPE cpstColorProfileSubType,
DWORD dwProfileID,
DWORD cbProfileName,
LPWSTR pProfileName
);
參數
scope
指定此設定檔管理作業範圍的 WCS_PROFILE_MANAGEMENT_SCOPE 值。
pDeviceName
取得預設色彩設定檔之裝置名稱的指標。 如果 為 Null，則會取得與裝置無關的預設設定檔。
cptColorProfileType
指定色彩配置檔案類型的 COLORPROFILETYPE 值。
cpstColorProfileSubType
指定色彩設定檔子類型的 COLORPROFILESUBTYPE 值。
dwProfileID
色彩設定檔所代表之色彩空間的識別碼。
cbProfileName
由 pProfileName指向之緩衝區的緩衝區大小，以位元組為單位。
pProfileName
要接收色彩設定檔名稱之緩衝區的指標。 緩衝區的大小會以位元組為單位，以 cbProfileName表示。
傳回值
如果此函式成功，則傳回值為 TRUE。
如果此函式失敗，則傳回值為 FALSE。 如需擴充的錯誤資訊，請呼叫 GetLastError。
備註
使用 WcsGetDefaultColorProfileSize 函式，取得 pProfileName 參數所指向之緩衝區的必要大小。
如果WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER存在，它會覆寫 profileManagementScope的系統範圍預設值。
此函式可在 Least-Privileged 使用者帳戶 (LUA) 內容中執行。
需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 標頭 | icm.h |
| 程式庫 | Mscms.lib |
| Dll | Mscms.dll |