Funzione WcsAssociateColorProfileWithDevice (icm.h)
Associa un profilo di colore WCS specificato a un dispositivo specificato.
Nota
Questa API non supporta i profili "colore avanzati" per i monitor HDR. Usare ColorProfileAddDisplayAssociation per la gestione di profili di colore avanzati.
Sintassi
BOOL WcsAssociateColorProfileWithDevice(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pProfileName,
PCWSTR pDeviceName
);
Parametri
scope
Valore WCS_PROFILE_MANAGEMENT_SCOPE che specifica l'ambito di questa operazione di gestione del profilo, che potrebbe essere a livello di sistema o per l'utente corrente.
pProfileName
Puntatore al nome del file del profilo da associare.
pDeviceName
Puntatore al nome del dispositivo con cui deve essere associato il profilo.
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
La funzione WCSAssociateColorProfileWithDevice ha esito negativo se il profilo non è stato installato nel computer usando la funzione InstallColorProfileW .
Se il parametro profileManagementScope è WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, l'associazione del profilo è a livello di sistema e si applica a tutti gli utenti. Se profileManagementScope è WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, l'associazione è solo per l'utente corrente.
Questa funzione è eseguibile nel contesto dell'account utente Least-Privileged se profileManagementScope è WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER. In caso contrario, sono necessari privilegi amministrativi.
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 |