Freigeben über

DisassociateColorProfileFromDeviceA-Funktion (icm.h)

  • Artikel

Deaktiviert die Zuordnung eines angegebenen Farbprofils zu einem angegebenen Gerät auf einem angegebenen Computer.

Hinweis

Diese API unterstützt keine "erweiterten Farbprofile" für HDR-Monitore. Verwenden Sie ColorProfileRemoveDisplayAssociation zum Verwalten erweiterter Farbprofile.

Syntax

BOOL DisassociateColorProfileFromDeviceA(
  PCSTR pMachineName,
  PCSTR pProfileName,
  PCSTR pDeviceName
);

Parameter

pMachineName

Reserviert. Muss NULL sein. Dieser Parameter soll auf den Namen des Computers verweisen, auf dem das angegebene Profil und gerät nicht mehr zugeordnet werden soll. Ein NULL-Zeiger gibt den lokalen Computer an.

pProfileName

Zeiger auf den Dateinamen des Profils, das die Zuordnung aufheben soll.

pDeviceName

Zeiger auf den Namen des Geräts, das die Zuordnung aufheben soll.

Rückgabewert

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

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Wenn einem Gerät mehr als ein Profil zugeordnet ist, verwendet WCS das letzte zugeordnete Profil als Standard. Das heißt, wenn Ihre Anwendung einem Gerät nacheinander drei Profile zuordnet, verwendet WCS das letzte, das als Standard zugeordnet ist. Wenn Ihre Anwendung dann die DisassociateColorProfileFromDevice-Funktion aufruft , um die Zuordnung des dritten Profils zu aufheben (dies ist die Standardeinstellung in diesem Beispiel), verwendet der WCS das zweite Profil als Standard.

Wenn Ihre Anwendung die Zuordnung aller Profile zu einem Gerät auflöst, verwendet WCS das sRGB-Profil als Standard.

DisassociateColorProfileFromDevice entfernt das angegebene Profil immer aus der Benutzerprofilzuordnungsliste des aktuellen Benutzers für das angegebene Gerät. Vor dem Entfernen des Profils aus der Liste bestimmt DisassociateColorProfileFromDevice , ob der Benutzer zuvor den Wunsch geäußert hat, eine Benutzerprofilzuordnungsliste für das Gerät zu verwenden. Wenn dies der Fall ist, entfernt DisassociateColorProfileFromDevice einfach das angegebene Profil aus der vorhandenen Zuordnungsliste pro Benutzerprofil für das Gerät. Andernfalls erstellt DisassociateColorProfileFromDevice eine neue Benutzerprofilzuordnungsliste für das Gerät, indem die systemweite Zuordnungsliste für dieses Gerät kopiert wird. Anschließend wird das angegebene Profil aus der Liste pro Benutzer entfernt. Ab diesem Zeitpunkt verwendet der aktuelle Benutzer eine Benutzerprofilzuordnungsliste für das angegebene Gerät, als ob WcsSetUsePerUserProfiles für pDevice aufgerufen wurde, wobei der usePerUserProfiles-Parameter auf TRUE festgelegt ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile icm.h
Bibliothek Mscms.lib
DLL Mscms.dll

Weitere Informationen