共用方式為

WcsAssociateColorProfileWithDevice 函式 (icm.h)

  • 發行項

將指定的 WCS 色彩設定檔與指定的裝置產生關聯。

注意

此 API 不支援 HDR 監視器的「進階色彩」設定檔。 使用 ColorProfileAddDisplayAssociation 來管理進階色彩設定檔。

語法

BOOL WcsAssociateColorProfileWithDevice(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pProfileName,
  PCWSTR                       pDeviceName
);

參數

scope

WCS_PROFILE_MANAGEMENT_SCOPE值，指定此設定檔管理作業的範圍，這可以是全系統或目前使用者。

pProfileName

要關聯之設定檔檔案名的指標。

pDeviceName

要與設定檔相關聯之裝置名稱的指標。

傳回值

如果此函式成功，則傳回值為 TRUE。

如果此函式失敗，則傳回值為 FALSE。 如需擴充錯誤資訊，請呼叫 GetLastError。

備註

如果未使用InstallColorProfileW函式在電腦上安裝設定檔，WCSAssociateColorProfileWithDevice函式就會失敗。

如果 profileManagementScope 參數WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE，則設定檔關聯是全系統且適用于所有使用者。 如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，則關聯僅適用于目前的使用者。

如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，此函式會在 Least-Privileged 使用者帳戶 (LUA) 內容中執行。 否則，需要系統管理許可權。

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 icm.h
程式庫 Mscms.lib
Dll Mscms.dll

另請參閱