共用方式為

WcsOpenColorProfileA 函式 (icm.h)

  • 發行項

建立指定色彩設定檔的控制碼。

語法

HPROFILE WcsOpenColorProfileA(
  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

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

值 描述
PROFILE_READ 指定色彩設定檔開啟以供唯讀存取。
PROFILE_READWRITE 指定讀取和寫入存取權的色彩設定檔開啟。 如果設定檔是 WCS 設定檔，則會忽略此旗標的值。

dwShareMode

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

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

dwCreationMode

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

值 描述
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 HPROFILEs。 如果存在其他 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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 icm.h
程式庫 Mscms.lib
Dll Mscms.dll

另請參閱