WcsEnumColorProfiles 函式 (icm.h)
列舉與指定範圍內任何裝置相關聯的色彩設定檔。
注意
此 API 不支援 HDR 監視器的「進階色彩」設定檔。 使用 ColorProfileGetDisplayList 來管理進階色彩設定檔。
語法
BOOL WcsEnumColorProfiles(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PENUMTYPEW pEnumRecord,
PBYTE pBuffer,
DWORD dwSize,
PDWORD pnProfiles
);
參數
scope
指定此設定檔管理作業範圍的 WCS_PROFILE_MANAGEMENT_SCOPE 值。
pEnumRecord
指定列舉準則之結構的指標。
pBuffer
要列舉設定檔名稱之緩衝區的指標。 WcsEnumColorProfiles函式會在此緩衝區中放置MULTI_SZ字串，其中包含符合*pEnumRecord中所指定準則的設定檔名稱。
dwSize
變數，包含 pBuffer所指向之緩衝區的大小，以位元組為單位。 請參閱備註。
pnProfiles
變數的選擇性指標，可接收復制到 pBuffer 指向之緩衝區的設定檔名稱數目。 如果不需要這項資訊，可以為 Null 。
傳回值
如果此函式成功，則傳回值為 TRUE。
如果此函式失敗，則傳回值為 FALSE。 如需擴充錯誤資訊，請呼叫 GetLastError。
備註
使用 WcsEnumColorProfilesSize 函式來擷取 dwSize 參數的值，也就是 pBuffer 參數所指向之緩衝區的大小，以位元組為單位。
如果 profileManagementScope 參數WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE，則只會考慮全系統將設定檔關聯至裝置。 如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，則只會考慮目前使用者的個別使用者關聯。 如果從未為此使用者呼叫 WcsSetUsePerUserProfiles ，或 WcsSetUsePerUserProfiles 最近針對此使用者呼叫，且其 usePerUserProfiles 參數設定為 FALSE， 則 WCSEnumColorProfiles 會傳回空的清單。
如果WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER (目前使用者設定) 存在，它會覆寫 profileManagementScope 參數的系統全系統預設值。
此函式在 LUA) 內容 (使用者帳戶 Least-Privileged 可執行檔。
需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 | icm.h |
| 程式庫 | Mscms.lib |
| Dll | Mscms.dll |