AssociateColorProfileWithDeviceA 関数 (icm.h)

指定したカラー プロファイルを指定したデバイスに関連付けます。

構文

BOOL AssociateColorProfileWithDeviceA(
  PCSTR pMachineName,
  PCSTR pProfileName,
  PCSTR pDeviceName
);

パラメーター

pMachineName

予約済み。 NULL にする必要があります。 このパラメーターは、指定されたプロファイルとデバイスを関連付けるコンピューターの名前を指すことを目的としています。 NULL ポインターは、ローカル コンピューターを示します。

pProfileName

関連付けるプロファイルのファイル名をポイントします。

pDeviceName

関連付けるデバイスの名前をポイントします。

戻り値

この関数が成功した場合、戻り値は TRUE になります。

この関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報については、 GetLastError を呼び出します。

注釈

InstallColorProfileW 関数を使用してプロファイルがコンピューターにインストールされていない場合、AssociateColorProfileWithDevice 関数は失敗します。

Windows (Windows 95 以降) では、プリンター用の PostScript デバイス ドライバーでは CMYK カラー モデルが想定されていることに注意してください。 したがって、すべての PostScript プリンターで CMYK カラー プロファイルを使用する必要があります。 Windows 2000 には、この制限はありません。

指定されたデバイスがモニターの場合、この関数は既定のプロファイルを更新します。

通常、いくつかのプロファイルは、用紙とインクの種類に基づいてプリンターに関連付けられます。 既定値はありません。 GDI は、アプリケーションがデバイス コンテキスト (DC) を作成するときに、関連付けられているプロファイルから最適なものを選択します。

スキャナーには既定のプロファイルもありません。 ただし、複数のプロファイルをスキャナーに関連付けるのは非定型です。

AssociateColorProfileWithDevice は、指定したデバイスの現在のユーザーごとのプロファイル関連付けリストに、指定したプロファイルを常に追加します。 プロファイルをリストに追加する前に、 AssociateColorProfileWithDevice は、ユーザーがデバイスに対してユーザーごとのプロファイル関連付けリストを使用する必要があることを以前に表現したかどうかを判断します。 その場合、 AssociateColorProfileWithDevice は、指定されたプロファイルをデバイスの既存のユーザーごとのプロファイル関連付けリストに追加するだけです。 そうでない場合、 AssociateColorProfileWithDevice は、そのデバイスのシステム全体の関連付けリストをコピーすることによって、デバイスの新しいユーザーごとのプロファイル関連付けリストを作成します。 その後、指定したプロファイルがユーザーごとの一覧に追加されます。 その時点から、現在のユーザーは、usePerUserProfiles パラメーターが TRUE に設定された pDevice に対して WcsSetUsePerUserProfiles が呼び出されたかのように、指定されたデバイスのユーザーごとのプロファイル関連付けリストを使用します。

Requirements

こちらも参照ください

• 基本的な色管理の概念
• 関数
• DisassociateColorProfileFromDevice