將指定的色彩設定檔與指定的裝置建立關聯。
備註
此 API 不支援 HDR 監視器的「進階色彩」設定檔。 使用 ColorProfileAddDisplayAssociation 來管理進階色彩設定檔。
語法
BOOL AssociateColorProfileWithDeviceA(
PCSTR pMachineName,
PCSTR pProfileName,
PCSTR 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 會複製該裝置的全系統關聯清單，以建立新的每個使用者設定檔關聯清單。 然後，它會將指定的設定檔附加至每個使用者清單。 從該點開始，目前的使用者將會針對指定的裝置使用每個使用者配置檔關聯清單，就像已針對 pDevice 呼叫 WcsSetUsePerUserProfiles 一樣，並將 usePerUserProfiles 參數設定為 TRUE。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 10 內部版本 20348 |
| 支援的最低伺服器 | Windows 10 內部版本 20348 |
| Header | icm.h |
| Library | Mscms.Lib |