SetStandardColorSpaceProfileW 函式 (icm.h)

為指定的標準色彩空間註冊指定的設定檔。您可以使用 GetStandardColorSpaceProfileW查詢設定檔。

語法

BOOL SetStandardColorSpaceProfileW(
  PCWSTR pMachineName,
  DWORD  dwProfileID,
  PCWSTR 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 內容中執行，否則存取遭拒，因為安裝是全系統且需要系統管理員許可權。