DisassociateColorProfileFromDeviceW-Funktion (icm.h)
Zuordnen 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 DisassociateColorProfileFromDeviceW(
PCWSTR pMachineName,
PCWSTR pProfileName,
PCWSTR pDeviceName
);
Parameter
pMachineName
Reserviert. Muss NULL sein. Dieser Parameter soll auf den Namen des Computers verweisen, auf dem das angegebene Profil und das angegebene Gerät nicht zugeordnet werden sollen. Ein NULL-Zeiger gibt den lokalen Computer an.
pProfileName
Zeiger auf den Dateinamen des Zu trennenden Profils.
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 mehrere Profile zugeordnet sind, verwendet WCS das letzte, das als Standard zugeordnet ist. Das heißt, wenn Ihre Anwendung einem Gerät sequenziell 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 trennen (dies ist in diesem Beispiel der Standard), verwendet das WCS das zweite Profil als Standard.
Wenn Ihre Anwendung alle Profile einem Gerät nicht zugeordnet, 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 Profilzuordnungsliste pro Benutzer für das angegebene Gerät, als ob WcsSetUsePerUserProfiles für pDevice aufgerufen wurde und der usePerUserProfiles-Parameter auf TRUE festgelegt ist.
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 |