Freigeben über

UpdateICMRegKeyA-Funktion (wingdi.h)

  • Artikel

(veraltet; aus Gründen der Abwärtskompatibilität beibehalten)

Die UpdateICMRegKey Funktion verwaltet Farbprofile und Farbverwaltungsmodule im System.

Syntax

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

Parameter

reserved

Reserviert, muss auf Null festgelegt werden.

lpszCMID

Verweist auf eine Zeichenfolge, die den ICC-Profilbezeichner für die Farbverwaltungs-DLL angibt, die mit dem Profil verwendet werden soll.

lpszFileName

Verweist auf einen vollqualifizierten ICC-Farbprofildateinamen oder auf eine DEVMODE--Struktur.

command

Gibt eine auszuführende Funktion an. Er kann einen der folgenden Werte aufweisen.

 

Wert Bedeutung
ICM_ADDPROFILE
 Installiert das ICC-Profil im System.
ICM_DELETEPROFILE
 Deinstalliert das ICC-Profil aus dem System, löscht die Datei jedoch nicht.
ICM_QUERYPROFILE
 Bestimmt, ob das Profil bereits im System installiert ist.
ICM_SETDEFAULTPROFILE
 Macht das Profil zuerst unter gleich.
ICM_REGISTERICMATCHER
 Registriert ein CMM im System. Der pszFileName Parameter verweist auf einen vollqualifizierten Pfad für die CMM-DLL. Der parameter lpszCMID verweist auf einen DWORD-, der das CMM identifiziert.
ICM_UNREGISTERICMATCHER
 Hebt die Registrierung des CMM vom System auf. Der parameter lpszCMID verweist auf einen DWORD-, der das CMM identifiziert.
ICM_QUERYMATCH
 Bestimmt, ob ein Profil basierend auf der DEVMODE- Struktur vorhanden ist, auf die der pszFileName-Parameter verweist.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE.

Bemerkungen

Nicht alle Parameter werden von allen Funktionen verwendet. Der parameter nCommand gibt die auszuführende Funktion an.

Diese Funktion wird aus Gründen der Abwärtskompatibilität beibehalten und kann in zukünftigen Versionen von ICM entfernt werden.

Windows 95/98/Me: UpdateICMRegKeyW wird von Microsoft Layer für Unicode unterstützt. Um dies zu verwenden, müssen Sie Ihrer Anwendung bestimmte Dateien hinzufügen, wie in Microsoft Layer for Unicode unter Windows 95/98/Me Systemsbeschrieben.

Anmerkung

Der wingdi.h-Header definiert UpdateICMRegKey als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Zielplattform- Fenster
Header- wingdi.h
Library Gdi32.lib
DLL- Gdi32.dll

Siehe auch