AssociateColorProfileWithDeviceA 関数 (icm.h)
指定したカラー プロファイルを指定したデバイスに関連付けます。
注意
この API では、HDR モニターの "高度な色" プロファイルはサポートされていません。 ColorProfileAddDisplayAssociation を使用して、高度なカラー プロファイルを管理します。
構文
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 が呼び出されたかのように、指定されたデバイスに対してユーザーごとのプロファイル関連付けリストを使用します。
要件
| サポートされている最小のクライアント | Windows 10 ビルド 20348 |
| サポートされている最小のサーバー | Windows 10 ビルド 20348 |
| Header | icm.h |