共用方式為

UpdateICMRegKeyW 函式 （wingdi.h）

  • 發行項

（已過時;保留為回溯兼容性）

UpdateICMRegKey 函式會管理系統中的色彩設定檔和色彩管理模組。

語法

BOOL UpdateICMRegKeyW(
  DWORD  reserved,
  LPWSTR lpszCMID,
  LPWSTR lpszFileName,
  UINT   command
);

參數

reserved

保留的 必須設定為零。

lpszCMID

指向字串，指定色彩管理 DLL 與設定檔搭配使用的 ICC 設定檔識別碼。

lpszFileName

指向完整 ICC 色彩設定檔檔名稱，或指向 DEVMODE 結構。

command

指定要執行的函式。 它可以有下列其中一個值。

 

價值 意義
ICM_ADDPROFILE
 在系統中安裝 ICC 設定檔。
ICM_DELETEPROFILE
 從系統卸載 ICC 設定檔，但不會刪除檔案。
ICM_QUERYPROFILE
 判斷配置檔是否已安裝在系統中。
ICM_SETDEFAULTPROFILE
 先將配置檔設為相等。
ICM_REGISTERICMATCHER
 在系統中註冊 CMM。 pszFileName 參數會指向 CMM DLL 的完整路徑。 lpszCMID 參數指向識別 CMM DWORD。
ICM_UNREGISTERICMATCHER
 從系統取消註冊 CMM。 lpszCMID 參數指向識別 CMM DWORD。
ICM_QUERYMATCH
 根據 pszFileName 參數所指向的 DEVMODE 結構，判斷配置檔是否存在。

傳回值

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

如果函式失敗傳回值會 FALSE。

言論

並非所有函式都會使用所有參數。 nCommand 參數會指定要執行的函式。

此函式會保留供回溯相容性使用，而且未來ICM版本可能會移除。

Windows 95/98/Me：Unicode Microsoft 層支援 UpdateICMRegKeyW。 若要使用此功能，您必須將特定檔案新增至您的應用程式，如 Windows 95/98/Me Systems上 Microsoft Layer for Unicode 中所述。

注意

wingdi.h 標頭會將 UpdateICMRegKey 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 wingdi.h
連結庫 Gdi32.lib
DLL Gdi32.dll

另請參閱