EnumColorProfilesW 函式 （icm.h）

列舉滿足指定列舉準則的所有設定檔。

語法

BOOL EnumColorProfilesW(
  PCWSTR     pMachineName,
  PENUMTYPEW pEnumRecord,
  PBYTE      pEnumerationBuffer,
  PDWORD     pdwSizeOfEnumerationBuffer,
  PDWORD     pnProfiles
);

參數

pMachineName

已保留。 必須是 Null。 此參數旨在指向要列舉配置檔的電腦名稱。 NULL 指標表示本機電腦。

pEnumRecord

指定列舉準則之結構的指標。

pEnumerationBuffer

要列舉配置檔的緩衝區指標。 符合 *pEnumRecord 中指定準則的設定檔名稱MULTI_SZ字串將會放置在此緩衝區中。

pdwSizeOfEnumerationBuffer

變數的指標，其中包含 pBuffer 所指向的緩衝區大小。 傳回時， *pdwSize 包含實際使用或需要的緩衝區大小。

pnProfiles

變數的指標，該變數將包含實際複製到緩衝區的設定檔名稱數目。

返回值

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

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

備註

根據紙張和墨水類型，通常有數個設定檔與印表機相關聯。 每個裝置都有一個預設設定檔。 針對國際色彩聯盟 （ICC） 配置檔，當您的應用程式建立裝置內容 （DC） 時，GDI 會從 ICC 相關聯的配置檔中選取最佳配置檔。

請勿嘗試使用 EnumColorProfiles 來判斷裝置的預設配置檔。 相反地，請建立裝置的裝置內容，然後叫用 GetICMProfile 函式。 在 Windows Vista 和 Windows 7 上， WcsGetDefaultColorProfile 函式也可以用來判斷裝置的預設色彩配置檔。

如果 pEnumRecord 參數所指向之 ENUMTYPE 類型結構的 dwFields 成員設定為 ET_DEVICENAME，則此函式會列舉與連結至使用者電腦的所有裝置類型相關聯的所有色彩配置檔，而不論裝置類別為何。 如果 pEnumRecord 參數所指向結構的 dwFields 成員設定為 ET_DEVICENAME 或 ET_DEVICECLASS，而且在結構的 dwDeviceClass 成員中指定裝置類別，則此函式只會列舉與指定裝置類別相關聯的配置檔。 如果 dwFields 成員只設定為 ET_DEVICECLASS，則 EnumColorProfiles 函式會列舉可與該類型裝置相關聯的所有配置檔。

每當 EnumColorProfiles 檢查與特定裝置相關聯的配置檔時，結果取決於使用者是否選擇使用與該裝置相關聯的全系統配置檔清單，或他或她自己的 （「每個使用者」） 清單。 呼叫 WcsSetUsePerUserProfiles 並將其 usePerUserProfiles 參數設定為 TRUE 會導致未來呼叫 EnumColorProfiles 只查看目前使用者針對指定裝置的每個使用者設定檔關聯清單。 呼叫 WcsSetUsePerUserProfiles 並將其 usePerUserProfiles 參數設定為 FALSE 會導致未來呼叫 EnumColorProfiles 來查看指定裝置的全系統配置檔關聯清單。 如果從未針對目前使用者呼叫 WcsSetUsePerUserProfiles ，則 EnumColorProfiles 會檢查全系統清單。

您的應用程式可以使用 EnumColorProfiles 來取得列舉配置檔的緩衝區大小。 它應該呼叫 EnumColorProfiles 函式，並將 pBuffer 參數設定為 Null。 當函式傳回時， pdwSize 參數會包含必要的緩衝區大小 （以位元組為單位）。 您的程式可以使用該資訊來配置列舉緩衝區。 然後，它可以再次叫用 EnumColorProfiles ，並將 pBuffer 參數設定為緩衝區的位址。

此函式會提供將 WCS 特定 DMP 資訊轉換成舊版 EnumType 記錄的資訊，以啟用一致的配置檔列舉。 如果此資訊不存在，則預設值將與ICC相同。

每個使用者/LUA 支援

列舉是目前使用者特有的。 系統範圍和現行使用者裝置關聯都會被考慮。 對於預設設定檔設定，目前的使用者設定會覆寫系統範圍的設定。

需求

另請參閱

• 基本色彩管理概念
• 函數
• GetICMProfile
• ENUMTYPEW