disassociateColorProfileFromDeviceW 函式 (icm.h)
將指定的色彩設定檔與指定電腦上的指定裝置解除關聯。
注意
此 API 不支援 HDR 監視器的「進階色彩」設定檔。 使用 ColorProfileRemoveDisplayAssociation 來管理進階色彩設定檔。
語法
BOOL DisassociateColorProfileFromDeviceW(
PCWSTR pMachineName,
PCWSTR pProfileName,
PCWSTR pDeviceName
);
參數
pMachineName
保留的。 必須是 Null。 此參數旨在指向要解除指定設定檔和裝置關聯之電腦的名稱。 Null指標表示本機電腦。
pProfileName
要解除關聯之設定檔檔案名的指標。
pDeviceName
要解除關聯之裝置名稱的指標。
傳回值
如果此函式成功，則傳回值為 TRUE。
如果此函式失敗，則傳回值為 FALSE。 如需擴充錯誤資訊，請呼叫 GetLastError。
備註
如果有多個設定檔與裝置相關聯，WCS 會使用最後一個相關聯的設定檔做為預設值。 也就是說，如果您的應用程式循序將三個設定檔與裝置產生關聯，WCS 將會使用最後一個相關聯的設定檔作為預設值。 如果您的應用程式接著呼叫 DisassociateColorProfileFromDevice 函式，以解除第三個設定檔的關聯 (這是此範例中的預設值) ，WCS 會使用第二個設定檔做為預設值。
如果您的應用程式與裝置的所有設定檔解除關聯，WCS 會使用 sRGB 設定檔作為預設值。
DisassociateColorProfileFromDevice 一律會從指定裝置的目前使用者個別使用者設定檔關聯清單中移除指定的設定檔。 從清單中移除設定檔之前， DisassociateColorProfileFromDevice 會決定使用者先前是否表示想要針對裝置使用個別使用者設定檔關聯清單。 如果是，則 DisassociateColorProfileFromDevice 只會從裝置的現有個別使用者設定檔關聯清單中移除指定的設定檔。 如果沒有，則藉由複製該裝置的系統範圍關聯清單，取消 關聯ColorProfileFromDevice 為裝置建立新的個別使用者設定檔關聯清單。 然後，它會從每個使用者清單中移除指定的設定檔。 從該點開始，目前的使用者將會針對指定的裝置使用個別使用者設定檔關聯清單，就像 WcsSetUsePerUserProfiles 已針對 pDevice 呼叫， 而 usePerUserProfiles 參數設定為 TRUE。
需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 | icm.h |
| 程式庫 | Mscms.lib |
| Dll | Mscms.dll |