AssociateColorProfileWithDeviceW 関数 (icm.h)
指定したカラー プロファイルを指定したデバイスに関連付けます。
注意
この API では、HDR モニターの "高度な色" プロファイルはサポートされていません。 ColorProfileAddDisplayAssociation を使用して、高度なカラー プロファイルを管理します。
構文
BOOL AssociateColorProfileWithDeviceW(
PCWSTR pMachineName,
PCWSTR pProfileName,
PCWSTR 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 が呼び出されたかのように、指定されたデバイスのユーザーごとのプロファイル関連付けリストを使用します。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| Header | icm.h |
| Library | Mscms.lib |
| [DLL] | Mscms.dll |