Freigeben über

SetStandardColorSpaceProfileW-Funktion (icm.h)

  • Artikel

Registriert ein angegebenes Profil für einen bestimmten Standardfarbraum. Das Profil kann mit GetStandardColorSpaceProfileW abgefragt werden.

Syntax

BOOL SetStandardColorSpaceProfileW(
  PCWSTR pMachineName,
  DWORD  dwProfileID,
  PCWSTR pProfileName
);

Parameter

pMachineName

Reserviert. Muss NULL sein. Dieser Parameter soll auf den Namen des Computers verweisen, auf dem ein Standardfarbraumprofil festgelegt werden soll. Ein NULL-Zeiger gibt den lokalen Computer an.

dwProfileID

Gibt den ID-Wert des Standardfarbraums an, den das angegebene Profil darstellt. Dies ist ein benutzerdefinierter ID-Wert, der zum eindeutigen Identifizieren des Farbraumprofils in Ihrer Anwendung verwendet wird.

pProfileName

Zeigt auf einen vollqualifizierten Pfad zur Profildatei.

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 Profil muss bereits auf dem System installiert sein, bevor es für einen Standardfarbraum registriert werden kann.

Diese Funktion unterstützt zusätzlich zu ICC-Profilen (International Color Consortium) auch Gerätemodellprofile (Windows Color System, WCS). Es unterstützt keine WCS CAMP- oder GMMP-Profile und gibt einen Fehler zurück, wenn solche Profile verwendet werden.

Unterstützung pro Benutzer/LUA

Dadurch wird ein angegebenes Profil für einen bestimmten Standardfarbraum nur für den aktuellen Benutzer registriert.

Dabei wird WcsSetDefaultColorProfile mit WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER verwendet.

Dies ist im LUA-Kontext ausführbar, wenn das Profil bereits installiert ist. Andernfalls tritt ein Fehler auf, wenn der Zugriff verweigert wird, da die Installation systemweit erfolgt und Administratorrechte erfordert.

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

Weitere Informationen