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 関数は、このバッファーに、*pEnumRecord で指定された条件を満たすプロファイル名で構成されるMULTI_SZ文字列を配置します。
dwSize
pBuffer が指すバッファーのサイズ (バイト単位) を含む変数。 「解説」を参照してください。
pnProfiles
pBuffer が指すバッファーにコピーされるプロファイル名の数を受け取る変数への省略可能なポインター。 この情報が必要ない場合は NULL にすることができます 。
戻り値
この関数が成功した場合、戻り値は TRUE になります。
この関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報については、 GetLastError を呼び出します。
解説
wcsEnumColorProfilesSize 関数を使用して、pBuffer パラメーターが指すバッファーのサイズ (バイト単位) である dwSize パラメーターの値を取得します。
profileManagementScope パラメーターがWCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE場合、デバイスへのプロファイルのシステム全体の関連付けのみが考慮されます。 profileManagementScope がWCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER場合、現在のユーザーのユーザーごとの関連付けのみが考慮されます。 このユーザーに対して WcsSetUsePerUserProfiles が呼び出されたことがない場合、または usePerUserProfiles パラメーターが FALSE に設定されたこのユーザーに対して WcsSetUsePerUserProfiles が最後に呼び出された場合、WCSEnumColorProfiles は空のリストを返します。
WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER (現在のユーザー設定) が存在する場合、 profileManagementScope パラメーターのシステム全体の既定値がオーバーライドされます。
この関数は、ユーザー アカウント (LUA) コンテキスト Least-Privileged 実行可能です。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| Header | icm.h |
| Library | Mscms.lib |
| [DLL] | Mscms.dll |