Funzione WcsSetDefaultColorProfile (icm.h)
Imposta il nome del profilo di colore predefinito per il tipo di profilo specificato nell'ambito di gestione del profilo specificato.
Nota
Questa API non supporta i profili "colore avanzati" per i monitor HDR. Usare ColorProfileSetDisplayDefaultAssociation per la gestione di profili di colore avanzati.
Sintassi
BOOL WcsSetDefaultColorProfile(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pDeviceName,
COLORPROFILETYPE cptColorProfileType,
COLORPROFILESUBTYPE cpstColorProfileSubType,
DWORD dwProfileID,
LPCWSTR pProfileName
);
Parametri
scope
Valore WCS_PROFILE_MANAGEMENT_SCOPE che specifica l'ambito di questa operazione di gestione del profilo.
pDeviceName
Puntatore al nome del dispositivo per il quale deve essere impostato il profilo di colore predefinito. Se NULL viene usato un profilo predefinito indipendente dal dispositivo.
cptColorProfileType
Valore COLORPROFILETYPE che specifica il tipo di profilo di colore.
cpstColorProfileSubType
Valore COLORPROFILESUBTYPE che specifica il sottotipo del profilo di colore.
dwProfileID
ID dello spazio dei colori rappresentato dal profilo di colore. Si tratta di un valore ID personalizzato usato per identificare in modo univoco il profilo dello spazio dei colori all'interno dell'applicazione.
pProfileName
Puntatore a un buffer che contiene il nome del profilo di colore. Vedere la sezione Osservazioni.
Valore restituito
Se questa funzione ha esito positivo, il valore restituito è TRUE.
Se questa funzione ha esito negativo, il valore restituito è FALSE. Per informazioni sull'errore estese, chiamare GetLastError.
Commenti
Se il parametro pProfileName è NULL e il parametro profileManagementScope è WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, le chiamate successive a WcsSetDefaultColorProfile restituiranno il profilo predefinito a livello di sistema.
Se profileManagementScope è WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, questa funzione è eseguibile nel contesto dell'account utente Least-Privileged. In caso contrario, sono necessari privilegi amministrativi. Il profilo specificato deve essere già installato, ma potrebbe non essere ancora associato al dispositivo specificato nell'ambito di gestione del profilo specificato.
Se profileManagementScope è WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, questa funzione non funzionerà correttamente se avviata dal contesto di sistema e non da un account utente.
Quando WcsSetDefaultColorProfile viene chiamato per impostare un profilo del modello di dispositivo DMP come profilo predefinito per lo spazio di lavoro RGB o personalizzato, solo un profilo DMP di tipo RGBVirtualDevice, LCD o CRT è valido; tutti gli altri non sono validi.
Quando WcsSetDefaultColorProfile viene chiamato per impostare un profilo International Color Consortium (ICC) come profilo predefinito per lo spazio di lavoro RGB o personalizzato, solo un profilo ICC con classe "spac" o "disp" e "RGB" è valido; tutti gli altri non sono validi.
Vedere le note sulle combinazioni di tipo di profilo/sottotipo valide.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | icm.h |
| Libreria | Mscms.lib |
| DLL | Mscms.dll |