AssociateColorProfileWithDeviceW 函式 (icm.h)
將指定的色彩設定檔與指定的裝置產生關聯。
注意
此 API 不支援 HDR 監視器的「進階色彩」設定檔。 使用 ColorProfileAddDisplayAssociation 來管理進階色彩設定檔。
語法
BOOL AssociateColorProfileWithDeviceW(
PCWSTR pMachineName,
PCWSTR pProfileName,
PCWSTR pDeviceName
);
參數
pMachineName
保留的。 必須是 Null。 此參數旨在指向建立指定設定檔和裝置關聯之電腦的名稱。 Null指標表示本機電腦。
pProfileName
指向要關聯的設定檔檔案名。
pDeviceName
指向要關聯的裝置名稱。
傳回值
如果此函式成功，則傳回值為 TRUE。
如果此函式失敗，則傳回值為 FALSE。 如需擴充錯誤資訊，請呼叫 GetLastError。
備註
如果未使用InstallColorProfileW函式在電腦上安裝設定檔，AssociateColorProfileWithDevice函式將會失敗。
請注意，在 Windows (Windows 95 或更新版本) 下，印表機的 PostScript 裝置驅動程式會假設 CMYK 色彩模型。 因此，所有 PostScript 印表機都必須使用 CMYK 色彩設定檔。 Windows 2000 沒有這項限制。
如果指定的裝置是監視器，此函式會更新預設設定檔。
根據紙張和筆跡類型，數個設定檔通常與印表機相關聯。 沒有預設值。 當您的應用程式建立裝置內容 (DC) 時，GDI 會從相關聯的設定檔中選取最佳設定檔。
掃描器也沒有任何預設設定檔。 不過，將多個設定檔與掃描器產生關聯是非典型的。
AssociateColorProfileWithDevice 一律會將指定的設定檔新增至指定裝置的目前使用者個別使用者設定檔關聯清單。 將設定檔新增至清單中之前， AssociateColorProfileWithDevice 會決定使用者先前是否表示想要針對裝置使用個別使用者設定檔關聯清單。 如果是， 則 AssociateColorProfileWithDevice 只會將指定的設定檔新增至裝置的現有個別使用者設定檔關聯清單。 如果沒有， 則 AssociateColorProfileWithDevice 會複製該裝置的系統範圍關聯清單，為裝置建立新的個別使用者設定檔關聯清單。 然後，它會將指定的設定檔附加至每個使用者清單。 從該點開始，目前的使用者將會針對指定的裝置使用個別使用者設定檔關聯清單，就像 WcsSetUsePerUserProfiles 已針對 pDevice 呼叫， 而 usePerUserProfiles 參數設定為 TRUE。
需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 | icm.h |
| 程式庫 | Mscms.lib |
| Dll | Mscms.dll |