WcsAssociateColorProfileWithDevice-Funktion (icm.h)
Ordnet einem angegebenen Gerät ein angegebenes WCS-Farbprofil zu.
Hinweis
Diese API unterstützt keine "erweiterten Farbprofile" für HDR-Monitore. Verwenden Sie ColorProfileAddDisplayAssociation zum Verwalten erweiterter Farbprofile.
Syntax
BOOL WcsAssociateColorProfileWithDevice(
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 zu zuordnenden Profils.
pDeviceName
Ein Zeiger auf den Namen des Geräts, dem das Profil 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
Die WCSAssociateColorProfileWithDevice-Funktion schlägt fehl, wenn das Profil nicht mithilfe der InstallColorProfileW-Funktion auf dem Computer installiert wurde.
Wenn der parameter profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE ist, ist die Profilzuordnung systemweit und gilt für alle Benutzer. Wenn profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER ist, gilt die Zuordnung nur für den aktuellen Benutzer.
Diese Funktion ist im Least-Privileged LUA-Kontext (User Account, Benutzerkonto) ausführbar, wenn profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER ist. 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 |