WcsDisassociateColorProfileFromDevice-Funktion (icm.h)
Entfernt die Zuordnung eines angegebenen WCS-Farbprofils zu einem angegebenen Gerät auf einem Computer.
Hinweis
Diese API unterstützt keine "erweiterten Farbprofile" für HDR-Monitore. Verwenden Sie ColorProfileRemoveDisplayAssociation zum Verwalten erweiterter Farbprofile.
Syntax
BOOL WcsDisassociateColorProfileFromDevice(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pProfileName,
PCWSTR pDeviceName
);
Parameter
scope
Ein WCS_PROFILE_MANAGEMENT_SCOPE Wert, der den Bereich dieses Profilverwaltungsvorgangs angibt, der systemweit oder für den aktuellen Benutzer sein kann.
pProfileName
Ein Zeiger auf den Dateinamen des Profils, das die Zuordnung aufheben soll.
pDeviceName
Ein Zeiger auf den Namen des Geräts, dem das Profil nicht zugeordnet werden 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
Das WCS-Farbprofil sollte installiert werden. Darüber hinaus müssen Sie den gleichen profileManagementScope-Wert wie zu dem Zeitpunkt verwenden, zu dem das Gerät dem Profil zugeordnet wurde. Siehe WcsAssociateColorProfileWithDevice.
Wenn profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE ist, erfolgt die Profiltrennung systemweit und gilt für alle Benutzer. Wenn profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER ist, gilt die Trennung nur für den aktuellen Benutzer.
Wenn einem Gerät mehrere Farbprofile zugeordnet sind, verwendet WCS das letzte zugeordnete Profil als Standard. Wenn Ihre Anwendung beispielsweise einem Gerät drei Profile sequenziell zuordnet, verwendet WCS das letzte zugeordnete Profil als Standard. Wenn Ihre Anwendung dann die WcsDisassociateColorProfileFromDevice-Funktion aufruft , um die Zuordnung des dritten Profils zu aufheben (dies ist die Standardeinstellung in diesem Beispiel), verwendet 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.
Wenn profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER ist, ist diese Funktion in Least-Privileged LUA-Kontext (User Account) ausführbar. Andernfalls sind Administratorrechte erforderlich.
Anforderungen
| 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 |