disassociateColorProfileFromDeviceA 函式 (icm.h)
將指定的色彩配置檔與指定計算機上的指定裝置解除關聯。
注意
此 API 不支援 HDR 監視器的「進階色彩」配置檔。 使用 ColorProfileRemoveDisplayAssociation 來管理進階色彩配置檔。
語法
BOOL DisassociateColorProfileFromDeviceA(
PCSTR pMachineName,
PCSTR pProfileName,
PCSTR 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 |