共用方式為

WcsOpenColorProfileW 函式 (icm.h)

  • 發行項

建立指定之色彩配置檔的句柄。

語法

HPROFILE WcsOpenColorProfileW(
  PPROFILE pCDMPProfile,
  PPROFILE pCAMPProfile,
  PPROFILE pGMMPProfile,
  DWORD    dwDesireAccess,
  DWORD    dwShareMode,
  DWORD    dwCreationMode,
  DWORD    dwFlags
);

參數

pCDMPProfile

指定設定檔的 WCS DMP 或 ICC 色彩設定檔結構的指標。 您可以在建立句柄之後釋放 pCDMPProfile 指標。 如果配置檔是 ICC，且其 dwType 成員設定為 DONT_USE_EMBEDDED_WCS_PROFILES，WcsOpenColorProfile 會忽略在 ICC 配置檔內的任何內嵌 WCS 配置檔。

pCAMPProfile

配置文件結構的指標，指定 WCS 色彩外觀模型設定檔 (CAMP) 。 您可以在建立句柄之後釋放 pCAMPProfile 指標。 如果為 NULL，則會使用預設 CAMP，而且查詢預設 CAMP 時會使用目前使用者設定WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER。

pGMMPProfile

配置文件結構的指標，指定 WCS 遊戲地圖模型設定檔 (GMMP) 。 您可以在建立句柄之後釋放 pGMMPProfile 指標。 如果為 NULL，則會使用預設轉譯意圖的預設 GMMP，而且查詢預設 GMMP 時會使用目前的使用者設定WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER。 如需轉譯意圖的描述，請參閱轉譯 意圖。

dwDesireAccess

旗標值，指定如何存取指定的色彩配置檔。 此參數必須採用下列其中一個值：

值 Description
PROFILE_READ 指定色彩設定檔開啟以進行唯讀存取。
PROFILE_READWRITE 指定針對讀取和寫入存取開啟色彩配置檔。 如果設定檔是 WCS 設定檔，則會忽略此旗標的值。

dwShareMode

旗標值，指定開啟檔案中包含的色彩配置檔時所要採取的動作。 此參數必須採用下列其中一個值，這些值定義於 winnt.h 中：

值 Description
FILE_SHARE_READ 指定您可以在設定檔上執行讀取存取) 作業的其他開啟 (。
FILE_SHARE_WRITE 指定您可以在設定檔上執行寫入存取) 作業的其他開啟 (。 開啟 WCS 設定檔時，會忽略此旗標值。

dwCreationMode

旗標值，指定在檔案中包含色彩配置檔時，開啟色彩配置檔時所要採取的動作。 此參數必須採用下列其中一個值，這些值定義於 winbase.h：

值 Description
CREATE_NEW 指定已建立新的設定檔。 如果配置檔已經存在，此函式就會失敗。
CREATE_ALWAYS 指定已建立新的設定檔。 如果配置檔已經存在，則會覆寫它。
OPEN_EXISTING 指定開啟配置檔。 如果配置檔不存在，此函式就會失敗。
OPEN_ALWAYS 指定如果國際色彩聯盟 () 檔案存在，則會開啟配置檔。 如果 ICC 設定檔不存在，WCS 會建立新的 ICC 配置檔。 如果設定此旗標且 WCS 設定檔不存在，則 WCS 設定檔的函式將會失敗。
TRUNCATE_EXISTING 指定要開啟配置檔，並將其截斷為零個字節。 如果配置檔不存在，則函式會失敗。

dwFlags

旗標值，指定是否要使用內嵌的 WCS 設定檔。 除非 pCDMProfile 指定包含內嵌 WCS 設定檔的 ICC 配置檔，否則此參數沒有任何作用。

此參數採用下列其中一個值：

值 描述
0 指定將使用內嵌的 WCS 設定檔，並忽略 pCDMPProfile 所指定的 ICC 設定檔。
DONT_USE_EMBEDDED_WCS_PROFILES 指定將會使用 pCDMPProfile 指定的 ICC 設定檔，並忽略內嵌的 WCS 設定檔。

傳回值

如果此函式成功，傳回值就是開啟之色彩配置檔的句柄。

如果此函式失敗，則傳回值為 NULL。

備註

此 API 會採用一組 DMP、CAMP 和 GMMP，並傳回 WCS 設定檔句柄。 GMMP 的 NULL 值有效。 CAMP 的 NULL 值將會取代為預設的 CAMP 值。

此 API 也會接受 ICC 設定檔。 使用 ICC 設定檔不保證 WCS CITE 引擎的處理。 只有在傳遞至少一個 WCS 配置檔時，才會使用 WCS 引擎。 單純的 ICC 工作流程會與舊版行為一致。

您可以使用此函式在其他色彩設定檔管理功能中傳回的句柄。

dwCreationMode 旗標CREATE_NEW、CREATE_ALWAYS和TRUNCATE_EXISTING一律會傳回空白的 ICC HPROFIES。 如果存在其他 dwCreationMode 旗標，此函式會判斷配置檔是 ICC 還是 WCS XML。

在 ICC 代碼路徑內，會使用上述表格中指定的要求共用、存取和建立旗標，傳回 ICC HPROFILE。

在 WCS 路徑中，如果配置檔不存在， dwCreationMode 旗標OPEN_ALWAYS將會失敗，因為無法在 WCS 架構內建立或編輯 WCS 配置檔， (必須使用 MSXML6) 編輯它們。 基於相同的原因， dwShareMode 旗標FILE_SHARE_WRITE，而 dwDesiredAccess 旗標PROFILE_READWRITE則會在 WCS 路徑中忽略。

建立色彩配置檔的句柄之後，就可以刪除用來建立該句柄的任何資訊。

使用 CloseColorProfile 函式關閉 WcsOpenColorProfile 所傳回的物件句柄。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
標頭 icm.h
程式庫 Mscms.lib
Dll Mscms.dll

另請參閱