WcsDisassociateColorProfileFromDevice 函式 (icm.h)
將指定的 WCS 色彩設定檔與電腦上的指定裝置解除關聯。
注意
此 API 不支援 HDR 監視器的「進階色彩」設定檔。 使用 ColorProfileRemoveDisplayAssociation 來管理進階色彩設定檔。
語法
BOOL WcsDisassociateColorProfileFromDevice(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pProfileName,
PCWSTR pDeviceName
);
參數
scope
WCS_PROFILE_MANAGEMENT_SCOPE值，指定此設定檔管理作業的範圍，這可以是全系統或目前使用者。
pProfileName
要解除關聯之設定檔檔案名的指標。
pDeviceName
要解除設定檔關聯之裝置名稱的指標。
傳回值
如果此函式成功，則傳回值為 TRUE。
如果此函式失敗，則傳回值為 FALSE。 如需擴充錯誤資訊，請呼叫 GetLastError。
備註
應該安裝 WCS 色彩設定檔。 此外，您必須使用與設定檔相關聯的裝置時相同的 profileManagementScope 值。 請參閱 WcsAssociateColorProfileWithDevice。
如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE，則設定檔解除關聯是全系統且適用于所有使用者。 如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，則解除關聯僅適用于目前的使用者。
如果有多個色彩設定檔與裝置相關聯，WCS 會使用最後一個相關聯的設定檔做為預設值。 例如，如果您的應用程式循序將三個設定檔與裝置產生關聯，WCS 會使用最後一個相關聯的設定檔做為預設值。 如果您的應用程式接著呼叫 WcsDisassociateColorProfileFromDevice 函式，以解除第三個設定檔的關聯 (這是此範例中的預設值) ，WCS 會使用第二個設定檔做為預設值。
如果您的應用程式與裝置的所有設定檔解除關聯，WCS 會使用 sRGB 設定檔作為預設值。
如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，此函式會在 Least-Privileged 使用者帳戶 (LUA) 內容中執行。 否則，需要系統管理許可權。
需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 | icm.h |
| 程式庫 | Mscms.lib |
| Dll | Mscms.dll |