WcsAssociateColorProfileWithDevice 関数 (icm.h)
指定した WCS カラー プロファイルを指定したデバイスに関連付けます。
注意
この API では、HDR モニターの "高度な色" プロファイルはサポートされていません。 ColorProfileAddDisplayAssociation を使用して、高度なカラー プロファイルを管理します。
構文
BOOL WcsAssociateColorProfileWithDevice(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pProfileName,
PCWSTR pDeviceName
);
パラメーター
scope
このプロファイル管理操作のスコープを指定する WCS_PROFILE_MANAGEMENT_SCOPE 値 。システム全体または現在のユーザーの場合があります。
pProfileName
関連付けるプロファイルのファイル名へのポインター。
pDeviceName
プロファイルを関連付けるデバイスの名前へのポインター。
戻り値
この関数が成功した場合、戻り値は TRUE になります。
この関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報については、 GetLastError を呼び出します。
解説
プロファイルが InstallColorProfileW 関数を使用してコンピューターにインストールされていない場合、WCSAssociateColorProfileWithDevice 関数は失敗します。
profileManagementScope パラメーターがWCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDEされている場合、プロファイルの関連付けはシステム全体で行われ、すべてのユーザーに適用されます。 profileManagementScope がWCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER場合、関連付けは現在のユーザーに対してのみ行われます。
profileManagementScope がWCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USERされている場合、この関数はユーザー アカウント (LUA) コンテキスト Least-Privileged 実行可能です。 それ以外の場合は、管理特権が必要です。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
Header | icm.h |
Library | Mscms.lib |
[DLL] | Mscms.dll |