次の方法で共有

DisassociateColorProfileFromDeviceW 関数 (icm.h)

  • [アーティクル]

指定したコンピューター上の指定したデバイスと指定したカラー プロファイルの関連付けを解除します。

Note

この API では、HDR モニターの "高度な色" プロファイルはサポートされていません。 ColorProfileRemoveDisplayAssociation を使用して、高度なカラー プロファイルを管理します。

構文

BOOL DisassociateColorProfileFromDeviceW(
  PCWSTR pMachineName,
  PCWSTR pProfileName,
  PCWSTR pDeviceName
);

パラメーター

pMachineName

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

pProfileName

関連付けを解除するプロファイルのファイル名へのポインター。

pDeviceName

関連付けを解除するデバイスの名前へのポインター。

戻り値

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

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

解説

1 つのデバイスに複数のプロファイルが関連付けられている場合、WCS はデフォルトとして最後に関連付けられたプロファイルを使用します。 つまり、アプリケーションが 3 つのプロファイルをデバイスに順番に関連付ける場合、WCS は既定として関連付けられた最後のプロファイルを使用します。 アプリケーションで DisassociateColorProfileFromDevice 関数を呼び出して 3 番目のプロファイルの関連付けを解除する場合 (この例では既定値)、WCS は 2 番目のプロファイルを既定値として使用します。

アプリケーションがデバイスからすべてのプロファイルの関連付けを解除した場合、WCS は既定として sRGB プロファイルを使用します。

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

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header icm.h
Library Mscms.lib
[DLL] Mscms.dll

関連項目