次の方法で共有

UpdateICMRegKeyA 関数 (wingdi.h)

  • [アーティクル]

(古い。旧バージョンとの互換性のために保持されます)

UpdateICMRegKey 関数は、システム内のカラー プロファイルとカラー管理モジュールを管理します。

構文

BOOL UpdateICMRegKeyA(
  DWORD reserved,
  LPSTR lpszCMID,
  LPSTR lpszFileName,
  UINT  command
);

パラメーター

reserved

予約済み。0 に設定する必要があります。

lpszCMID

プロファイルで使用するカラー管理 DLL の ICC プロファイル識別子を指定する文字列を指します。

lpszFileName

完全修飾 ICC カラー プロファイル ファイル名または DEVMODE 構造体を指します。

command

実行する関数を指定します。 次のいずれかの値を指定できます。

 

値 説明
ICM_ADDPROFILE
 ICC プロファイルをシステムにインストールします。
ICM_DELETEPROFILE
 システムから ICC プロファイルをアンインストールしますが、ファイルは削除しません。
ICM_QUERYPROFILE
 プロファイルがシステムに既にインストールされているかどうかを判断します。
ICM_SETDEFAULTPROFILE
 プロファイルを次の値の中で最初に作成します。
ICM_REGISTERICMATCHER
 システムに CMM を登録します。 pszFileName パラメーターは、CMM DLL の完全修飾パスを指します。 lpszCMID パラメーターは、CMM を識別する DWORD を指します。
ICM_UNREGISTERICMATCHER
 システムから CMM の登録を解除します。 lpszCMID パラメーターは、CMM を識別する DWORD を指します。
ICM_QUERYMATCH
 pszFileName パラメーターが指す DEVMODE 構造体に基づいてプロファイルが存在するかどうかを判断します。

戻り値

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

この関数が失敗した場合、戻り値は FALSE になります。

解説

すべてのパラメーターがすべての関数で使用されるわけではありません。 nCommand パラメーターは、実行する関数を指定します。

この関数は下位互換性のために保持され、今後のバージョンの ICM で削除される可能性があります。

Windows 95/98/Me: UpdateICMRegKeyW は、Microsoft Layer for Unicode でサポートされています。 これを使用するには、「 Microsoft Layer for Unicode on Windows 95/98/Me Systems」で説明されているように、特定のファイルをアプリケーションに追加する必要があります。

注意

wingdi.h ヘッダーは、UpdateICMRegKey をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wingdi.h
Library Gdi32.lib
[DLL] Gdi32.dll

関連項目