WcsDisassociateColorProfileFromDevice 関数 (icm.h)
指定した WCS カラー プロファイルの関連付けを、コンピューター上の指定したデバイスから解除します。
注意
この API では、HDR モニターの "高度な色" プロファイルはサポートされていません。 ColorProfileRemoveDisplayAssociation を使用して、高度なカラー プロファイルを管理します。
構文
BOOL WcsDisassociateColorProfileFromDevice(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pProfileName,
PCWSTR pDeviceName
);
パラメーター
scope
このプロファイル管理操作のスコープ (システム全体または現在のユーザー) を指定する WCS_PROFILE_MANAGEMENT_SCOPE 値。
pProfileName
関連付けを解除するプロファイルのファイル名へのポインター。
pDeviceName
プロファイルの関連付けを解除するデバイスの名前へのポインター。
戻り値
この関数が成功した場合、戻り値は TRUE になります。
この関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報については、 GetLastError を呼び出します。
解説
WCS カラー プロファイルをインストールする必要があります。 さらに、デバイスがプロファイルに関連付けられたときと同じ profileManagementScope 値を使用する必要があります。 「WcsAssociateColorProfileWithDevice」を参照してください。
profileManagementScope がWCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDEされている場合、プロファイルの関連付け解除はシステム全体で行われ、すべてのユーザーに適用されます。 profileManagementScope がWCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USERされている場合、関連付けの解除は現在のユーザーに対してのみ行います。
1 つのデバイスに複数のカラー プロファイルが関連付けられている場合、WCS では最後に関連付けられたプロファイルが既定値として使用されます。 たとえば、アプリケーションが 3 つのプロファイルをデバイスに順番に関連付ける場合、WCS は既定として関連付けられた最後のプロファイルを使用します。 その後、アプリケーションが WcsDisassociateColorProfileFromDevice 関数を呼び出して 3 番目のプロファイル (この例では既定値) の関連付けを解除した場合、WCS は 2 番目のプロファイルを既定値として使用します。
アプリケーションがデバイスからすべてのプロファイルの関連付けを解除した場合、WCS では sRGB プロファイルが既定値として使用されます。
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 |