次の方法で共有

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

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wingdi.h
ライブラリ Gdi32.lib
DLL Gdi32.dll

関連項目