次の方法で共有


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

関連項目